/*
 * Copyright (C) 2024 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package android.widget;

import static android.Manifest.permission.INTERACT_ACROSS_USERS_FULL;
import static android.content.res.Configuration.ORIENTATION_PORTRAIT;
import static android.view.ContentInfo.FLAG_CONVERT_TO_PLAIN_TEXT;
import static android.view.ContentInfo.SOURCE_AUTOFILL;
import static android.view.ContentInfo.SOURCE_CLIPBOARD;
import static android.view.ContentInfo.SOURCE_PROCESS_TEXT;
import static android.view.accessibility.AccessibilityNodeInfo.EXTRA_DATA_RENDERING_INFO_KEY;
import static android.view.accessibility.AccessibilityNodeInfo.EXTRA_DATA_TEXT_CHARACTER_LOCATION_ARG_LENGTH;
import static android.view.accessibility.AccessibilityNodeInfo.EXTRA_DATA_TEXT_CHARACTER_LOCATION_ARG_START_INDEX;
import static android.view.accessibility.AccessibilityNodeInfo.EXTRA_DATA_TEXT_CHARACTER_LOCATION_KEY;
import static android.view.inputmethod.CursorAnchorInfo.FLAG_HAS_VISIBLE_REGION;

import static com.android.text.flags.Flags.FLAG_FIX_LINE_HEIGHT_FOR_LOCALE;
import static com.android.text.flags.Flags.FLAG_USE_BOUNDS_FOR_WIDTH;

import android.R;
import android.annotation.CallSuper;
import android.annotation.CheckResult;
import android.annotation.ColorInt;
import android.annotation.DrawableRes;
import android.annotation.FlaggedApi;
import android.annotation.FloatRange;
import android.annotation.IntDef;
import android.annotation.IntRange;
import android.annotation.NonNull;
import android.annotation.Nullable;
import android.annotation.Px;
import android.annotation.RequiresPermission;
import android.annotation.Size;
import android.annotation.StringRes;
import android.annotation.StyleRes;
import android.annotation.TestApi;
import android.annotation.XmlRes;
import android.app.Activity;
import android.app.PendingIntent;
import android.app.assist.AssistStructure;
import android.app.compat.CompatChanges;
import android.compat.annotation.ChangeId;
import android.compat.annotation.EnabledSince;
import android.compat.annotation.UnsupportedAppUsage;
import android.content.ClipData;
import android.content.ClipDescription;
import android.content.ClipboardManager;
import android.content.Context;
import android.content.Intent;
import android.content.UndoManager;
import android.content.pm.PackageManager;
import android.content.res.ColorStateList;
import android.content.res.CompatibilityInfo;
import android.content.res.Configuration;
import android.content.res.FontScaleConverterFactory;
import android.content.res.Resources;
import android.content.res.TypedArray;
import android.content.res.XmlResourceParser;
import android.graphics.BaseCanvas;
import android.graphics.BlendMode;
import android.graphics.Canvas;
import android.graphics.Color;
import android.graphics.Insets;
import android.graphics.Matrix;
import android.graphics.Paint;
import android.graphics.Paint.FontMetricsInt;
import android.graphics.Path;
import android.graphics.PointF;
import android.graphics.PorterDuff;
import android.graphics.Rect;
import android.graphics.RectF;
import android.graphics.Typeface;
import android.graphics.drawable.Drawable;
import android.graphics.fonts.FontStyle;
import android.graphics.fonts.FontVariationAxis;
import android.graphics.text.LineBreakConfig;
import android.icu.text.DecimalFormatSymbols;
import android.os.AsyncTask;
import android.os.Build;
import android.os.Build.VERSION_CODES;
import android.os.Bundle;
import android.os.CancellationSignal;
import android.os.Handler;
import android.os.LocaleList;
import android.os.Parcel;
import android.os.Parcelable;
import android.os.ParcelableParcel;
import android.os.Process;
import android.os.SystemClock;
import android.os.UserHandle;
import android.provider.Settings;
import android.text.BoringLayout;
import android.text.ClientFlags;
import android.text.DynamicLayout;
import android.text.Editable;
import android.text.GetChars;
import android.text.GraphemeClusterSegmentFinder;
import android.text.GraphicsOperations;
import android.text.Highlights;
import android.text.InputFilter;
import android.text.InputType;
import android.text.Layout;
import android.text.NoCopySpan;
import android.text.ParcelableSpan;
import android.text.PrecomputedText;
import android.text.SegmentFinder;
import android.text.Selection;
import android.text.SpanWatcher;
import android.text.Spannable;
import android.text.SpannableStringBuilder;
import android.text.Spanned;
import android.text.SpannedString;
import android.text.StaticLayout;
import android.text.TextDirectionHeuristic;
import android.text.TextDirectionHeuristics;
import android.text.TextPaint;
import android.text.TextUtils;
import android.text.TextUtils.TruncateAt;
import android.text.TextWatcher;
import android.text.WordSegmentFinder;
import android.text.method.AllCapsTransformationMethod;
import android.text.method.ArrowKeyMovementMethod;
import android.text.method.DateKeyListener;
import android.text.method.DateTimeKeyListener;
import android.text.method.DialerKeyListener;
import android.text.method.DigitsKeyListener;
import android.text.method.KeyListener;
import android.text.method.LinkMovementMethod;
import android.text.method.MetaKeyKeyListener;
import android.text.method.MovementMethod;
import android.text.method.OffsetMapping;
import android.text.method.PasswordTransformationMethod;
import android.text.method.SingleLineTransformationMethod;
import android.text.method.TextKeyListener;
import android.text.method.TimeKeyListener;
import android.text.method.TransformationMethod;
import android.text.method.TransformationMethod2;
import android.text.method.WordIterator;
import android.text.style.CharacterStyle;
import android.text.style.ClickableSpan;
import android.text.style.ParagraphStyle;
import android.text.style.SpellCheckSpan;
import android.text.style.SuggestionSpan;
import android.text.style.URLSpan;
import android.text.style.UpdateAppearance;
import android.text.util.Linkify;
import android.util.ArraySet;
import android.util.AttributeSet;
import android.util.DisplayMetrics;
import android.util.IntArray;
import android.util.Log;
import android.util.SparseIntArray;
import android.util.TypedValue;
import android.view.AccessibilityIterators.TextSegmentIterator;
import android.view.ActionMode;
import android.view.Choreographer;
import android.view.ContentInfo;
import android.view.ContextMenu;
import android.view.DragEvent;
import android.view.Gravity;
import android.view.HapticFeedbackConstants;
import android.view.InputDevice;
import android.view.KeyCharacterMap;
import android.view.KeyEvent;
import android.view.MotionEvent;
import android.view.PointerIcon;
import android.view.View;
import android.view.ViewConfiguration;
import android.view.ViewDebug;
import android.view.ViewGroup;
import android.view.ViewGroup.LayoutParams;
import android.view.ViewHierarchyEncoder;
import android.view.ViewParent;
import android.view.ViewRootImpl;
import android.view.ViewStructure;
import android.view.ViewTreeObserver;
import android.view.accessibility.AccessibilityEvent;
import android.view.accessibility.AccessibilityManager;
import android.view.accessibility.AccessibilityNodeInfo;
import android.view.animation.AnimationUtils;
import android.view.autofill.AutofillManager;
import android.view.autofill.AutofillValue;
import android.view.contentcapture.ContentCaptureManager;
import android.view.contentcapture.ContentCaptureSession;
import android.view.inputmethod.BaseInputConnection;
import android.view.inputmethod.CompletionInfo;
import android.view.inputmethod.CorrectionInfo;
import android.view.inputmethod.CursorAnchorInfo;
import android.view.inputmethod.DeleteGesture;
import android.view.inputmethod.DeleteRangeGesture;
import android.view.inputmethod.EditorBoundsInfo;
import android.view.inputmethod.EditorInfo;
import android.view.inputmethod.ExtractedText;
import android.view.inputmethod.ExtractedTextRequest;
import android.view.inputmethod.HandwritingGesture;
import android.view.inputmethod.InputConnection;
import android.view.inputmethod.InputMethodManager;
import android.view.inputmethod.InsertGesture;
import android.view.inputmethod.InsertModeGesture;
import android.view.inputmethod.JoinOrSplitGesture;
import android.view.inputmethod.PreviewableHandwritingGesture;
import android.view.inputmethod.RemoveSpaceGesture;
import android.view.inputmethod.SelectGesture;
import android.view.inputmethod.SelectRangeGesture;
import android.view.inputmethod.TextAppearanceInfo;
import android.view.inputmethod.TextBoundsInfo;
import android.view.inspector.InspectableProperty;
import android.view.inspector.InspectableProperty.EnumEntry;
import android.view.inspector.InspectableProperty.FlagEntry;
import android.view.textclassifier.TextClassification;
import android.view.textclassifier.TextClassificationContext;
import android.view.textclassifier.TextClassificationManager;
import android.view.textclassifier.TextClassifier;
import android.view.textclassifier.TextLinks;
import android.view.textservice.SpellCheckerSubtype;
import android.view.textservice.TextServicesManager;
import android.view.translation.TranslationRequestValue;
import android.view.translation.TranslationSpec;
import android.view.translation.UiTranslationController;
import android.view.translation.ViewTranslationCallback;
import android.view.translation.ViewTranslationRequest;
import android.widget.RemoteViews.RemoteView;

import com.android.internal.accessibility.util.AccessibilityUtils;
import com.android.internal.annotations.VisibleForTesting;
import com.android.internal.graphics.ColorUtils;
import com.android.internal.inputmethod.EditableInputConnection;
import com.android.internal.logging.MetricsLogger;
import com.android.internal.logging.nano.MetricsProto.MetricsEvent;
import com.android.internal.util.ArrayUtils;
import com.android.internal.util.FastMath;
import com.android.internal.util.Preconditions;
import com.android.text.flags.Flags;

import libcore.util.EmptyArray;

import org.xmlpull.v1.XmlPullParserException;

import java.io.IOException;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.ref.WeakReference;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import java.util.Locale;
import java.util.Objects;
import java.util.Set;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.TimeUnit;
import java.util.function.Consumer;
import java.util.function.Supplier;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

/**
 * A user interface element that displays text to the user.
 * To provide user-editable text, see {@link EditText}.
 * <p>
 * The following code sample shows a typical use, with an XML layout
 * and code to modify the contents of the text view:
 * </p>

 * <pre>
 * &lt;LinearLayout
 xmlns:android="http://schemas.android.com/apk/res/android"
 android:layout_width="match_parent"
 android:layout_height="match_parent"&gt;
 *    &lt;TextView
 *        android:id="@+id/text_view_id"
 *        android:layout_height="wrap_content"
 *        android:layout_width="wrap_content"
 *        android:text="@string/hello" /&gt;
 * &lt;/LinearLayout&gt;
 * </pre>
 * <p>
 * This code sample demonstrates how to modify the contents of the text view
 * defined in the previous XML layout:
 * </p>
 * <pre>
 * public class MainActivity extends Activity {
 *
 *    protected void onCreate(Bundle savedInstanceState) {
 *         super.onCreate(savedInstanceState);
 *         setContentView(R.layout.activity_main);
 *         final TextView helloTextView = (TextView) findViewById(R.id.text_view_id);
 *         helloTextView.setText(R.string.user_greeting);
 *     }
 * }
 * </pre>
 * <p>
 * To customize the appearance of TextView, see <a href="https://developer.android.com/guide/topics/ui/themes.html">Styles and Themes</a>.
 * </p>
 * <p>
 * <b>XML attributes</b>
 * <p>
 * See {@link android.R.styleable#TextView TextView Attributes},
 * {@link android.R.styleable#View View Attributes}
 *
 * @attr ref android.R.styleable#TextView_text
 * @attr ref android.R.styleable#TextView_bufferType
 * @attr ref android.R.styleable#TextView_hint
 * @attr ref android.R.styleable#TextView_textColor
 * @attr ref android.R.styleable#TextView_textColorHighlight
 * @attr ref android.R.styleable#TextView_textColorHint
 * @attr ref android.R.styleable#TextView_textAppearance
 * @attr ref android.R.styleable#TextView_textColorLink
 * @attr ref android.R.styleable#TextView_textFontWeight
 * @attr ref android.R.styleable#TextView_textSize
 * @attr ref android.R.styleable#TextView_textScaleX
 * @attr ref android.R.styleable#TextView_fontFamily
 * @attr ref android.R.styleable#TextView_typeface
 * @attr ref android.R.styleable#TextView_textStyle
 * @attr ref android.R.styleable#TextView_cursorVisible
 * @attr ref android.R.styleable#TextView_maxLines
 * @attr ref android.R.styleable#TextView_maxHeight
 * @attr ref android.R.styleable#TextView_lines
 * @attr ref android.R.styleable#TextView_height
 * @attr ref android.R.styleable#TextView_minLines
 * @attr ref android.R.styleable#TextView_minHeight
 * @attr ref android.R.styleable#TextView_maxEms
 * @attr ref android.R.styleable#TextView_maxWidth
 * @attr ref android.R.styleable#TextView_ems
 * @attr ref android.R.styleable#TextView_width
 * @attr ref android.R.styleable#TextView_minEms
 * @attr ref android.R.styleable#TextView_minWidth
 * @attr ref android.R.styleable#TextView_gravity
 * @attr ref android.R.styleable#TextView_scrollHorizontally
 * @attr ref android.R.styleable#TextView_password
 * @attr ref android.R.styleable#TextView_singleLine
 * @attr ref android.R.styleable#TextView_selectAllOnFocus
 * @attr ref android.R.styleable#TextView_includeFontPadding
 * @attr ref android.R.styleable#TextView_maxLength
 * @attr ref android.R.styleable#TextView_shadowColor
 * @attr ref android.R.styleable#TextView_shadowDx
 * @attr ref android.R.styleable#TextView_shadowDy
 * @attr ref android.R.styleable#TextView_shadowRadius
 * @attr ref android.R.styleable#TextView_autoLink
 * @attr ref android.R.styleable#TextView_linksClickable
 * @attr ref android.R.styleable#TextView_numeric
 * @attr ref android.R.styleable#TextView_digits
 * @attr ref android.R.styleable#TextView_phoneNumber
 * @attr ref android.R.styleable#TextView_inputMethod
 * @attr ref android.R.styleable#TextView_capitalize
 * @attr ref android.R.styleable#TextView_autoText
 * @attr ref android.R.styleable#TextView_editable
 * @attr ref android.R.styleable#TextView_freezesText
 * @attr ref android.R.styleable#TextView_ellipsize
 * @attr ref android.R.styleable#TextView_drawableTop
 * @attr ref android.R.styleable#TextView_drawableBottom
 * @attr ref android.R.styleable#TextView_drawableRight
 * @attr ref android.R.styleable#TextView_drawableLeft
 * @attr ref android.R.styleable#TextView_drawableStart
 * @attr ref android.R.styleable#TextView_drawableEnd
 * @attr ref android.R.styleable#TextView_drawablePadding
 * @attr ref android.R.styleable#TextView_drawableTint
 * @attr ref android.R.styleable#TextView_drawableTintMode
 * @attr ref android.R.styleable#TextView_lineSpacingExtra
 * @attr ref android.R.styleable#TextView_lineSpacingMultiplier
 * @attr ref android.R.styleable#TextView_justificationMode
 * @attr ref android.R.styleable#TextView_marqueeRepeatLimit
 * @attr ref android.R.styleable#TextView_inputType
 * @attr ref android.R.styleable#TextView_imeOptions
 * @attr ref android.R.styleable#TextView_privateImeOptions
 * @attr ref android.R.styleable#TextView_imeActionLabel
 * @attr ref android.R.styleable#TextView_imeActionId
 * @attr ref android.R.styleable#TextView_editorExtras
 * @attr ref android.R.styleable#TextView_elegantTextHeight
 * @attr ref android.R.styleable#TextView_fallbackLineSpacing
 * @attr ref android.R.styleable#TextView_letterSpacing
 * @attr ref android.R.styleable#TextView_fontFeatureSettings
 * @attr ref android.R.styleable#TextView_fontVariationSettings
 * @attr ref android.R.styleable#TextView_breakStrategy
 * @attr ref android.R.styleable#TextView_hyphenationFrequency
 * @attr ref android.R.styleable#TextView_lineBreakStyle
 * @attr ref android.R.styleable#TextView_lineBreakWordStyle
 * @attr ref android.R.styleable#TextView_autoSizeTextType
 * @attr ref android.R.styleable#TextView_autoSizeMinTextSize
 * @attr ref android.R.styleable#TextView_autoSizeMaxTextSize
 * @attr ref android.R.styleable#TextView_autoSizeStepGranularity
 * @attr ref android.R.styleable#TextView_autoSizePresetSizes
 * @attr ref android.R.styleable#TextView_textCursorDrawable
 * @attr ref android.R.styleable#TextView_textSelectHandle
 * @attr ref android.R.styleable#TextView_textSelectHandleLeft
 * @attr ref android.R.styleable#TextView_textSelectHandleRight
 * @attr ref android.R.styleable#TextView_allowUndo
 * @attr ref android.R.styleable#TextView_enabled
 */
@RemoteView
public class TextView extends View implements ViewTreeObserver.OnPreDrawListener {
  static final String LOG_TAG = "TextView";
  static final boolean DEBUG_EXTRACT = false;
  static final boolean DEBUG_CURSOR = false;

  private static final float[] TEMP_POSITION = new float[2];

  // Enum for the "typeface" XML parameter.
  // TODO: How can we get this from the XML instead of hardcoding it here?
  /** @hide */
  @IntDef(value = {DEFAULT_TYPEFACE, SANS, SERIF, MONOSPACE})
  @Retention(RetentionPolicy.SOURCE)
  public @interface XMLTypefaceAttr{}
  private static final int DEFAULT_TYPEFACE = -1;
  private static final int SANS = 1;
  private static final int SERIF = 2;
  private static final int MONOSPACE = 3;

  // Enum for the "ellipsize" XML parameter.
  private static final int ELLIPSIZE_NOT_SET = -1;
  private static final int ELLIPSIZE_NONE = 0;
  private static final int ELLIPSIZE_START = 1;
  private static final int ELLIPSIZE_MIDDLE = 2;
  private static final int ELLIPSIZE_END = 3;
  private static final int ELLIPSIZE_MARQUEE = 4;

  // Bitfield for the "numeric" XML parameter.
  // TODO: How can we get this from the XML instead of hardcoding it here?
  private static final int SIGNED = 2;
  private static final int DECIMAL = 4;

  /**
   * Draw marquee text with fading edges as usual
   */
  private static final int MARQUEE_FADE_NORMAL = 0;

  /**
   * Draw marquee text as ellipsize end while inactive instead of with the fade.
   * (Useful for devices where the fade can be expensive if overdone)
   */
  private static final int MARQUEE_FADE_SWITCH_SHOW_ELLIPSIS = 1;

  /**
   * Draw marquee text with fading edges because it is currently active/animating.
   */
  private static final int MARQUEE_FADE_SWITCH_SHOW_FADE = 2;

  @UnsupportedAppUsage
  private static final int LINES = 1;
  private static final int EMS = LINES;
  private static final int PIXELS = 2;

  // Maximum text length for single line input.
  private static final int MAX_LENGTH_FOR_SINGLE_LINE_EDIT_TEXT = 5000;
  private InputFilter.LengthFilter mSingleLineLengthFilter = null;

  private static final RectF TEMP_RECTF = new RectF();

  /** @hide */
  static final int VERY_WIDE = 1024 * 1024; // XXX should be much larger
  private static final int ANIMATED_SCROLL_GAP = 250;

  private static final InputFilter[] NO_FILTERS = new InputFilter[0];
  private static final Spanned EMPTY_SPANNED = new SpannedString("");

  private static final int CHANGE_WATCHER_PRIORITY = 100;

  /**
   * The span priority of the {@link OffsetMapping} that is set on the text. It must be
   * higher than the {@link DynamicLayout}'s {@link TextWatcher}, so that the transformed text is
   * updated before {@link DynamicLayout#reflow(CharSequence, int, int, int)} being triggered
   * by {@link TextWatcher#onTextChanged(CharSequence, int, int, int)}.
   */
  private static final int OFFSET_MAPPING_SPAN_PRIORITY = 200;

  // New state used to change background based on whether this TextView is multiline.
  private static final int[] MULTILINE_STATE_SET = { R.attr.state_multiline };

  // Accessibility action to share selected text.
  private static final int ACCESSIBILITY_ACTION_SHARE = 0x10000000;

  /**
   * @hide
   */
  // Accessibility action start id for "process text" actions.
  static final int ACCESSIBILITY_ACTION_PROCESS_TEXT_START_ID = 0x10000100;

  /** Accessibility action start id for "smart" actions. @hide */
  static final int ACCESSIBILITY_ACTION_SMART_START_ID = 0x10001000;

  /**
   * @hide
   */
  @TestApi
  public static final int PROCESS_TEXT_REQUEST_CODE = 100;

  /**
   *  Return code of {@link #doKeyDown}.
   */
  private static final int KEY_EVENT_NOT_HANDLED = 0;
  private static final int KEY_EVENT_HANDLED = -1;
  private static final int KEY_DOWN_HANDLED_BY_KEY_LISTENER = 1;
  private static final int KEY_DOWN_HANDLED_BY_MOVEMENT_METHOD = 2;

  private static final int FLOATING_TOOLBAR_SELECT_ALL_REFRESH_DELAY = 500;

  // The default value of the line break style.
  private static final int DEFAULT_LINE_BREAK_STYLE = LineBreakConfig.LINE_BREAK_STYLE_NONE;

  // The default value of the line break word style.
  private static final int DEFAULT_LINE_BREAK_WORD_STYLE =
    LineBreakConfig.LINE_BREAK_WORD_STYLE_NONE;

  /**
   * This change ID enables the fallback text line spacing (line height) for BoringLayout.
   * @hide
   */
  @ChangeId
  @EnabledSince(targetSdkVersion = Build.VERSION_CODES.TIRAMISU)
  public static final long BORINGLAYOUT_FALLBACK_LINESPACING = 210923482L; // buganizer id

  /**
   * This change ID enables the fallback text line spacing (line height) for StaticLayout.
   * @hide
   */
  @ChangeId
  @EnabledSince(targetSdkVersion = Build.VERSION_CODES.P)
  public static final long STATICLAYOUT_FALLBACK_LINESPACING = 37756858; // buganizer id


  /**
   * This change ID enables the bounding box based layout.
   * @hide
   */
  @ChangeId
  @EnabledSince(targetSdkVersion = VERSION_CODES.VANILLA_ICE_CREAM)
  public static final long USE_BOUNDS_FOR_WIDTH = 63938206;  // buganizer id

  // System wide time for last cut, copy or text changed action.
  static long sLastCutCopyOrTextChangedTime;
  private ColorStateList mTextColor;
  private ColorStateList mHintTextColor;
  private ColorStateList mLinkTextColor;
  @ViewDebug.ExportedProperty(category = "text")

  /**
   * {@link #setTextColor(int)} or {@link #getCurrentTextColor()} should be used instead.
   */
  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P)
  private int mCurTextColor;

  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023)
  private int mCurHintTextColor;
  private boolean mFreezesText;

  @UnsupportedAppUsage
  private Editable.Factory mEditableFactory = Editable.Factory.getInstance();
  @UnsupportedAppUsage
  private Spannable.Factory mSpannableFactory = Spannable.Factory.getInstance();

  @UnsupportedAppUsage
  private float mShadowRadius;
  @UnsupportedAppUsage
  private float mShadowDx;
  @UnsupportedAppUsage
  private float mShadowDy;
  private int mShadowColor;

  private int mLastOrientation;

  private boolean mPreDrawRegistered;
  private boolean mPreDrawListenerDetached;

  private TextClassifier mTextClassifier;
  private TextClassifier mTextClassificationSession;
  private TextClassificationContext mTextClassificationContext;

  // A flag to prevent repeated movements from escaping the enclosing text view. The idea here is
  // that if a user is holding down a movement key to traverse text, we shouldn't also traverse
  // the view hierarchy. On the other hand, if the user is using the movement key to traverse
  // views (i.e. the first movement was to traverse out of this view, or this view was traversed
  // into by the user holding the movement key down) then we shouldn't prevent the focus from
  // changing.
  private boolean mPreventDefaultMovement;

  private TextUtils.TruncateAt mEllipsize;

  // A flag to indicate the cursor was hidden by IME.
  private boolean mImeIsConsumingInput;

  // Whether cursor is visible without regard to {@link mImeConsumesInput}.
  // {@code true} is the default value.
  private boolean mCursorVisibleFromAttr = true;

  static class Drawables {
    static final int LEFT = 0;
    static final int TOP = 1;
    static final int RIGHT = 2;
    static final int BOTTOM = 3;

    static final int DRAWABLE_NONE = -1;
    static final int DRAWABLE_RIGHT = 0;
    static final int DRAWABLE_LEFT = 1;

    final Rect mCompoundRect = new Rect();

    final Drawable[] mShowing = new Drawable[4];

    ColorStateList mTintList;
    BlendMode mBlendMode;
    boolean mHasTint;
    boolean mHasTintMode;

    Drawable mDrawableStart, mDrawableEnd, mDrawableError, mDrawableTemp;
    Drawable mDrawableLeftInitial, mDrawableRightInitial;

    boolean mIsRtlCompatibilityMode;
    boolean mOverride;

    int mDrawableSizeTop, mDrawableSizeBottom, mDrawableSizeLeft, mDrawableSizeRight,
      mDrawableSizeStart, mDrawableSizeEnd, mDrawableSizeError, mDrawableSizeTemp;

    int mDrawableWidthTop, mDrawableWidthBottom, mDrawableHeightLeft, mDrawableHeightRight,
      mDrawableHeightStart, mDrawableHeightEnd, mDrawableHeightError, mDrawableHeightTemp;

    int mDrawablePadding;

    int mDrawableSaved = DRAWABLE_NONE;

    public Drawables(Context context) {
      final int targetSdkVersion = context.getApplicationInfo().targetSdkVersion;
      mIsRtlCompatibilityMode = targetSdkVersion < VERSION_CODES.JELLY_BEAN_MR1
                                || !context.getApplicationInfo().hasRtlSupport();
      mOverride = false;
    }

    /**
     * @return {@code true} if this object contains metadata that needs to
     *         be retained, {@code false} otherwise
     */
    public boolean hasMetadata() {
      return mDrawablePadding != 0 || mHasTintMode || mHasTint;
    }

    /**
     * Updates the list of displayed drawables to account for the current
     * layout direction.
     *
     * @param layoutDirection the current layout direction
     * @return {@code true} if the displayed drawables changed
     */
    public boolean resolveWithLayoutDirection(int layoutDirection) {
      final Drawable previousLeft = mShowing[Drawables.LEFT];
      final Drawable previousRight = mShowing[Drawables.RIGHT];

      // First reset "left" and "right" drawables to their initial values
      mShowing[Drawables.LEFT] = mDrawableLeftInitial;
      mShowing[Drawables.RIGHT] = mDrawableRightInitial;

      if (mIsRtlCompatibilityMode) {
        // Use "start" drawable as "left" drawable if the "left" drawable was not defined
        if (mDrawableStart != null && mShowing[Drawables.LEFT] == null) {
          mShowing[Drawables.LEFT] = mDrawableStart;
          mDrawableSizeLeft = mDrawableSizeStart;
          mDrawableHeightLeft = mDrawableHeightStart;
        }
        // Use "end" drawable as "right" drawable if the "right" drawable was not defined
        if (mDrawableEnd != null && mShowing[Drawables.RIGHT] == null) {
          mShowing[Drawables.RIGHT] = mDrawableEnd;
          mDrawableSizeRight = mDrawableSizeEnd;
          mDrawableHeightRight = mDrawableHeightEnd;
        }
      } else {
        // JB-MR1+ normal case: "start" / "end" drawables are overriding "left" / "right"
        // drawable if and only if they have been defined
        switch(layoutDirection) {
          case LAYOUT_DIRECTION_RTL:
            if (mOverride) {
              mShowing[Drawables.RIGHT] = mDrawableStart;
              mDrawableSizeRight = mDrawableSizeStart;
              mDrawableHeightRight = mDrawableHeightStart;

              mShowing[Drawables.LEFT] = mDrawableEnd;
              mDrawableSizeLeft = mDrawableSizeEnd;
              mDrawableHeightLeft = mDrawableHeightEnd;
            }
            break;

          case LAYOUT_DIRECTION_LTR:
          default:
            if (mOverride) {
              mShowing[Drawables.LEFT] = mDrawableStart;
              mDrawableSizeLeft = mDrawableSizeStart;
              mDrawableHeightLeft = mDrawableHeightStart;

              mShowing[Drawables.RIGHT] = mDrawableEnd;
              mDrawableSizeRight = mDrawableSizeEnd;
              mDrawableHeightRight = mDrawableHeightEnd;
            }
            break;
        }
      }

      applyErrorDrawableIfNeeded(layoutDirection);

      return mShowing[Drawables.LEFT] != previousLeft
             || mShowing[Drawables.RIGHT] != previousRight;
    }

    public void setErrorDrawable(Drawable dr, TextView tv) {
      if (mDrawableError != dr && mDrawableError != null) {
        mDrawableError.setCallback(null);
      }
      mDrawableError = dr;

      if (mDrawableError != null) {
        final Rect compoundRect = mCompoundRect;
        final int[] state = tv.getDrawableState();

        mDrawableError.setState(state);
        mDrawableError.copyBounds(compoundRect);
        mDrawableError.setCallback(tv);
        mDrawableSizeError = compoundRect.width();
        mDrawableHeightError = compoundRect.height();
      } else {
        mDrawableSizeError = mDrawableHeightError = 0;
      }
    }

    private void applyErrorDrawableIfNeeded(int layoutDirection) {
      // first restore the initial state if needed
      switch (mDrawableSaved) {
        case DRAWABLE_LEFT:
          mShowing[Drawables.LEFT] = mDrawableTemp;
          mDrawableSizeLeft = mDrawableSizeTemp;
          mDrawableHeightLeft = mDrawableHeightTemp;
          break;
        case DRAWABLE_RIGHT:
          mShowing[Drawables.RIGHT] = mDrawableTemp;
          mDrawableSizeRight = mDrawableSizeTemp;
          mDrawableHeightRight = mDrawableHeightTemp;
          break;
        case DRAWABLE_NONE:
        default:
      }
      // then, if needed, assign the Error drawable to the correct location
      if (mDrawableError != null) {
        switch(layoutDirection) {
          case LAYOUT_DIRECTION_RTL:
            mDrawableSaved = DRAWABLE_LEFT;

            mDrawableTemp = mShowing[Drawables.LEFT];
            mDrawableSizeTemp = mDrawableSizeLeft;
            mDrawableHeightTemp = mDrawableHeightLeft;

            mShowing[Drawables.LEFT] = mDrawableError;
            mDrawableSizeLeft = mDrawableSizeError;
            mDrawableHeightLeft = mDrawableHeightError;
            break;
          case LAYOUT_DIRECTION_LTR:
          default:
            mDrawableSaved = DRAWABLE_RIGHT;

            mDrawableTemp = mShowing[Drawables.RIGHT];
            mDrawableSizeTemp = mDrawableSizeRight;
            mDrawableHeightTemp = mDrawableHeightRight;

            mShowing[Drawables.RIGHT] = mDrawableError;
            mDrawableSizeRight = mDrawableSizeError;
            mDrawableHeightRight = mDrawableHeightError;
            break;
        }
      }
    }
  }

  @UnsupportedAppUsage
  Drawables mDrawables;

  @UnsupportedAppUsage
  private CharWrapper mCharWrapper;

  @UnsupportedAppUsage(trackingBug = 124050217)
  private Marquee mMarquee;
  @UnsupportedAppUsage
  private boolean mRestartMarquee;

  private int mMarqueeRepeatLimit = 3;

  private int mLastLayoutDirection = -1;

  /**
   * On some devices the fading edges add a performance penalty if used
   * extensively in the same layout. This mode indicates how the marquee
   * is currently being shown, if applicable. (mEllipsize will == MARQUEE)
   */
  @UnsupportedAppUsage
  private int mMarqueeFadeMode = MARQUEE_FADE_NORMAL;

  /**
   * When mMarqueeFadeMode is not MARQUEE_FADE_NORMAL, this stores
   * the layout that should be used when the mode switches.
   */
  @UnsupportedAppUsage
  private Layout mSavedMarqueeModeLayout;

  // Do not update following mText/mSpannable/mPrecomputed except for setTextInternal()
  @ViewDebug.ExportedProperty(category = "text")
  @UnsupportedAppUsage
  private @Nullable CharSequence mText;
  private @Nullable Spannable mSpannable;
  private @Nullable PrecomputedText mPrecomputed;

  @UnsupportedAppUsage
  private CharSequence mTransformed;
  @UnsupportedAppUsage
  private BufferType mBufferType = BufferType.NORMAL;

  private CharSequence mHint;
  @UnsupportedAppUsage
  private Layout mHintLayout;
  private boolean mHideHint;

  private MovementMethod mMovement;

  private TransformationMethod mTransformation;
  @UnsupportedAppUsage
  private boolean mAllowTransformationLengthChange;
  @UnsupportedAppUsage
  private ChangeWatcher mChangeWatcher;

  @UnsupportedAppUsage(trackingBug = 123769451)
  private ArrayList<TextWatcher> mListeners;

  // display attributes
  @UnsupportedAppUsage
  private final TextPaint mTextPaint;
  @UnsupportedAppUsage
  private boolean mUserSetTextScaleX;
  @UnsupportedAppUsage
  private Layout mLayout;
  private boolean mLocalesChanged = false;
  private int mTextSizeUnit = -1;
  private int mLineBreakStyle = DEFAULT_LINE_BREAK_STYLE;
  private int mLineBreakWordStyle = DEFAULT_LINE_BREAK_WORD_STYLE;

  // This is used to reflect the current user preference for changing font weight and making text
  // more bold.
  private int mFontWeightAdjustment;
  private Typeface mOriginalTypeface;

  // True if setKeyListener() has been explicitly called
  private boolean mListenerChanged = false;
  // True if internationalized input should be used for numbers and date and time.
  private final boolean mUseInternationalizedInput;

  // Fallback fonts that end up getting used should be allowed to affect line spacing.
  private static final int FALLBACK_LINE_SPACING_NONE = 0;
  private static final int FALLBACK_LINE_SPACING_STATIC_LAYOUT_ONLY = 1;
  private static final int FALLBACK_LINE_SPACING_ALL = 2;

  private int mUseFallbackLineSpacing;
  // True if the view text can be padded for compat reasons, when the view is translated.
  private final boolean mUseTextPaddingForUiTranslation;

  private boolean mUseBoundsForWidth;
  private boolean mShiftDrawingOffsetForStartOverhang;
  @Nullable private Paint.FontMetrics mMinimumFontMetrics;
  @Nullable private Paint.FontMetrics mLocalePreferredFontMetrics;
  private boolean mUseLocalePreferredLineHeightForMinimum;

  @ViewDebug.ExportedProperty(category = "text")
  @UnsupportedAppUsage
  private int mGravity = Gravity.TOP | Gravity.START;
  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P)
  private boolean mHorizontallyScrolling;

  private int mAutoLinkMask;
  private boolean mLinksClickable = true;

  @UnsupportedAppUsage
  private float mSpacingMult = 1.0f;
  @UnsupportedAppUsage
  private float mSpacingAdd = 0.0f;

  /**
   * Remembers what line height was set to originally, before we broke it down into raw pixels.
   *
   * <p>This is stored as a complex dimension with both value and unit packed into one field!
   * {@see TypedValue}
   */
  private int mLineHeightComplexDimen;

  private int mBreakStrategy;
  private int mHyphenationFrequency;
  private int mJustificationMode;

  @UnsupportedAppUsage
  private int mMaximum = Integer.MAX_VALUE;
  @UnsupportedAppUsage
  private int mMaxMode = LINES;
  @UnsupportedAppUsage
  private int mMinimum = 0;
  @UnsupportedAppUsage
  private int mMinMode = LINES;

  @UnsupportedAppUsage
  private int mOldMaximum = mMaximum;
  @UnsupportedAppUsage
  private int mOldMaxMode = mMaxMode;

  @UnsupportedAppUsage
  private int mMaxWidth = Integer.MAX_VALUE;
  @UnsupportedAppUsage
  private int mMaxWidthMode = PIXELS;
  @UnsupportedAppUsage
  private int mMinWidth = 0;
  @UnsupportedAppUsage
  private int mMinWidthMode = PIXELS;

  @UnsupportedAppUsage
  private boolean mSingleLine;
  @UnsupportedAppUsage
  private int mDesiredHeightAtMeasure = -1;
  @UnsupportedAppUsage
  private boolean mIncludePad = true;
  private int mDeferScroll = -1;

  // tmp primitives, so we don't alloc them on each draw
  private Rect mTempRect;
  private long mLastScroll;
  private Scroller mScroller;
  private TextPaint mTempTextPaint;

  private Object mTempCursor;

  @UnsupportedAppUsage
  private BoringLayout.Metrics mBoring;
  @UnsupportedAppUsage
  private BoringLayout.Metrics mHintBoring;
  @UnsupportedAppUsage
  private BoringLayout mSavedLayout;
  @UnsupportedAppUsage
  private BoringLayout mSavedHintLayout;

  @UnsupportedAppUsage
  private TextDirectionHeuristic mTextDir;

  private InputFilter[] mFilters = NO_FILTERS;

  /**
   * {@link UserHandle} that represents the logical owner of the text. {@code null} when it is
   * the same as {@link Process#myUserHandle()}.
   *
   * <p>Most of applications should not worry about this. Some privileged apps that host UI for
   * other apps may need to set this so that the system can use right user's resources and
   * services such as input methods and spell checkers.</p>
   *
   * @see #setTextOperationUser(UserHandle)
   */
  @Nullable
  private UserHandle mTextOperationUser;

  private volatile Locale mCurrentSpellCheckerLocaleCache;

  // It is possible to have a selection even when mEditor is null (programmatically set, like when
  // a link is pressed). These highlight-related fields do not go in mEditor.
  @UnsupportedAppUsage
  int mHighlightColor = 0x6633B5E5;
  private Path mHighlightPath;
  @UnsupportedAppUsage
  private final Paint mHighlightPaint;
  @UnsupportedAppUsage
  private boolean mHighlightPathBogus = true;

  private List<Path> mHighlightPaths;
  private List<Paint> mHighlightPaints;
  private Highlights mHighlights;
  private int[] mSearchResultHighlights = null;
  private Paint mSearchResultHighlightPaint = null;
  private Paint mFocusedSearchResultHighlightPaint = null;
  private int mFocusedSearchResultHighlightColor = 0xFFFF9632;
  private int mSearchResultHighlightColor = 0xFFFFFF00;

  private int mFocusedSearchResultIndex = -1;
  private int mGesturePreviewHighlightStart = -1;
  private int mGesturePreviewHighlightEnd = -1;
  private Paint mGesturePreviewHighlightPaint;
  private final List<Path> mPathRecyclePool = new ArrayList<>();
  private boolean mHighlightPathsBogus = true;

  // Although these fields are specific to editable text, they are not added to Editor because
  // they are defined by the TextView's style and are theme-dependent.
  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P)
  int mCursorDrawableRes;
  private Drawable mCursorDrawable;
  // Note: this might be stale if setTextSelectHandleLeft is used. We could simplify the code
  // by removing it, but we would break apps targeting <= P that use it by reflection.
  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P)
  int mTextSelectHandleLeftRes;
  private Drawable mTextSelectHandleLeft;
  // Note: this might be stale if setTextSelectHandleRight is used. We could simplify the code
  // by removing it, but we would break apps targeting <= P that use it by reflection.
  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P)
  int mTextSelectHandleRightRes;
  private Drawable mTextSelectHandleRight;
  // Note: this might be stale if setTextSelectHandle is used. We could simplify the code
  // by removing it, but we would break apps targeting <= P that use it by reflection.
  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P)
  int mTextSelectHandleRes;
  private Drawable mTextSelectHandle;
  int mTextEditSuggestionItemLayout;
  int mTextEditSuggestionContainerLayout;
  int mTextEditSuggestionHighlightStyle;

  private static final int NO_POINTER_ID = -1;
  /**
   * The prime (the 1st finger) pointer id which is used as a lock to prevent multi touch among
   * TextView and the handle views which are rendered on popup windows.
   */
  private int mPrimePointerId = NO_POINTER_ID;

  /**
   * Whether the prime pointer is from the event delivered to selection handle or insertion
   * handle.
   */
  private boolean mIsPrimePointerFromHandleView;

  /**
   * {@link EditText} specific data, created on demand when one of the Editor fields is used.
   * See {@link #createEditorIfNeeded()}.
   */
  @UnsupportedAppUsage
  private Editor mEditor;

  private static final int DEVICE_PROVISIONED_UNKNOWN = 0;
  private static final int DEVICE_PROVISIONED_NO = 1;
  private static final int DEVICE_PROVISIONED_YES = 2;

  /**
   * Some special options such as sharing selected text should only be shown if the device
   * is provisioned. Only check the provisioned state once for a given view instance.
   */
  private int mDeviceProvisionedState = DEVICE_PROVISIONED_UNKNOWN;

  /**
   * The last input source on this TextView.
   *
   * Use the SOURCE_TOUCHSCREEN as the default value for backward compatibility. There could be a
   * non UI event originated ActionMode initiation, e.g. API call, a11y events, etc.
   */
  private int mLastInputSource = InputDevice.SOURCE_TOUCHSCREEN;

  /**
   * The TextView does not auto-size text (default).
   */
  public static final int AUTO_SIZE_TEXT_TYPE_NONE = 0;

  /**
   * The TextView scales text size both horizontally and vertically to fit within the
   * container.
   */
  public static final int AUTO_SIZE_TEXT_TYPE_UNIFORM = 1;

  /** @hide */
  @IntDef(prefix = { "AUTO_SIZE_TEXT_TYPE_" }, value = {
    AUTO_SIZE_TEXT_TYPE_NONE,
    AUTO_SIZE_TEXT_TYPE_UNIFORM
  })
  @Retention(RetentionPolicy.SOURCE)
  public @interface AutoSizeTextType {}
  // Default minimum size for auto-sizing text in scaled pixels.
  private static final int DEFAULT_AUTO_SIZE_MIN_TEXT_SIZE_IN_SP = 12;
  // Default maximum size for auto-sizing text in scaled pixels.
  private static final int DEFAULT_AUTO_SIZE_MAX_TEXT_SIZE_IN_SP = 112;
  // Default value for the step size in pixels.
  private static final int DEFAULT_AUTO_SIZE_GRANULARITY_IN_PX = 1;
  // Use this to specify that any of the auto-size configuration int values have not been set.
  private static final float UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE = -1f;
  // Auto-size text type.
  private int mAutoSizeTextType = AUTO_SIZE_TEXT_TYPE_NONE;
  // Specify if auto-size text is needed.
  private boolean mNeedsAutoSizeText = false;
  // Step size for auto-sizing in pixels.
  private float mAutoSizeStepGranularityInPx = UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE;
  // Minimum text size for auto-sizing in pixels.
  private float mAutoSizeMinTextSizeInPx = UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE;
  // Maximum text size for auto-sizing in pixels.
  private float mAutoSizeMaxTextSizeInPx = UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE;
  // Contains a (specified or computed) distinct sorted set of text sizes in pixels to pick from
  // when auto-sizing text.
  private int[] mAutoSizeTextSizesInPx = EmptyArray.INT;
  // Specifies whether auto-size should use the provided auto size steps set or if it should
  // build the steps set using mAutoSizeMinTextSizeInPx, mAutoSizeMaxTextSizeInPx and
  // mAutoSizeStepGranularityInPx.
  private boolean mHasPresetAutoSizeValues = false;

  // Autofill-related attributes
  //
  // Indicates whether the text was set statically or dynamically, so it can be used to
  // sanitize autofill requests.
  private boolean mTextSetFromXmlOrResourceId = false;
  // Resource id used to set the text.
  private @StringRes int mTextId = Resources.ID_NULL;
  // Resource id used to set the hint.
  private @StringRes int mHintId = Resources.ID_NULL;
  //
  // End of autofill-related attributes

  private Pattern mWhitespacePattern;

  /**
   * Kick-start the font cache for the zygote process (to pay the cost of
   * initializing freetype for our default font only once).
   * @hide
   */
  public static void preloadFontCache() {
    if (Typeface.ENABLE_LAZY_TYPEFACE_INITIALIZATION) {
      return;
    }
    Paint p = new Paint();
    p.setAntiAlias(true);
    // Ensure that the Typeface is loaded here.
    // Typically, Typeface is preloaded by zygote but not on all devices, e.g. Android Auto.
    // So, sets Typeface.DEFAULT explicitly here for ensuring that the Typeface is loaded here
    // since Paint.measureText can not be called without Typeface static initializer.
    p.setTypeface(Typeface.DEFAULT);
    // We don't care about the result, just the side-effect of measuring.
    p.measureText("H");
  }

  /**
   * Interface definition for a callback to be invoked when an action is
   * performed on the editor.
   */
  public interface OnEditorActionListener {
    /**
     * Called when an action is being performed.
     *
     * @param v The view that was clicked.
     * @param actionId Identifier of the action.  This will be either the
     * identifier you supplied, or {@link EditorInfo#IME_NULL
     * EditorInfo.IME_NULL} if being called due to the enter key
     * being pressed. Starting from Android 14, the action identifier will
     * also be included when triggered by an enter key if the input is
     * constrained to a single line.
     * @param event If triggered by an enter key, this is the event;
     * otherwise, this is null.
     * @return Return true if you have consumed the action, else false.
     */
    boolean onEditorAction(TextView v, int actionId, KeyEvent event);
  }

  public TextView(Context context) {
    this(context, null);
  }

  public TextView(Context context, @Nullable AttributeSet attrs) {
    this(context, attrs, com.android.internal.R.attr.textViewStyle);
  }

  public TextView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
    this(context, attrs, defStyleAttr, 0);
  }

  @SuppressWarnings("deprecation")
  public TextView(
    Context context, @Nullable AttributeSet attrs, int defStyleAttr, int defStyleRes) {
    super(context, attrs, defStyleAttr, defStyleRes);

    // TextView is important by default, unless app developer overrode attribute.
    if (getImportantForAutofill() == IMPORTANT_FOR_AUTOFILL_AUTO) {
      setImportantForAutofill(IMPORTANT_FOR_AUTOFILL_YES);
    }
    if (getImportantForContentCapture() == IMPORTANT_FOR_CONTENT_CAPTURE_AUTO) {
      setImportantForContentCapture(IMPORTANT_FOR_CONTENT_CAPTURE_YES);
    }

    setTextInternal("");

    final Resources res = getResources();
    final CompatibilityInfo compat = res.getCompatibilityInfo();

    mTextPaint = new TextPaint(Paint.ANTI_ALIAS_FLAG);
    mTextPaint.density = res.getDisplayMetrics().density;
    mTextPaint.setCompatibilityScaling(compat.applicationScale);

    mHighlightPaint = new Paint(Paint.ANTI_ALIAS_FLAG);
    mHighlightPaint.setCompatibilityScaling(compat.applicationScale);

    mMovement = getDefaultMovementMethod();

    mTransformation = null;

    final TextAppearanceAttributes attributes = new TextAppearanceAttributes();
    attributes.mTextColor = ColorStateList.valueOf(0xFF000000);
    attributes.mTextSize = 15;
    mBreakStrategy = Layout.BREAK_STRATEGY_SIMPLE;
    mHyphenationFrequency = Layout.HYPHENATION_FREQUENCY_NONE;
    mJustificationMode = Layout.JUSTIFICATION_MODE_NONE;
    mLastOrientation = getResources().getConfiguration().orientation;

    final Resources.Theme theme = context.getTheme();

    /*
     * Look the appearance up without checking first if it exists because
     * almost every TextView has one and it greatly simplifies the logic
     * to be able to parse the appearance first and then let specific tags
     * for this View override it.
     */
    TypedArray a = theme.obtainStyledAttributes(attrs,
                                                com.android.internal.R.styleable.TextViewAppearance, defStyleAttr, defStyleRes);
    saveAttributeDataForStyleable(context, com.android.internal.R.styleable.TextViewAppearance,
                                  attrs, a, defStyleAttr, defStyleRes);
    TypedArray appearance = null;
    int ap = a.getResourceId(
      com.android.internal.R.styleable.TextViewAppearance_textAppearance, -1);
    a.recycle();
    if (ap != -1) {
      appearance = theme.obtainStyledAttributes(
        ap, com.android.internal.R.styleable.TextAppearance);
      saveAttributeDataForStyleable(context, com.android.internal.R.styleable.TextAppearance,
                                    null, appearance, 0, ap);
    }
    if (appearance != null) {
      readTextAppearance(context, appearance, attributes, false /* styleArray */);
      attributes.mFontFamilyExplicit = false;
      appearance.recycle();
    }

    boolean editable = getDefaultEditable();
    CharSequence inputMethod = null;
    int numeric = 0;
    CharSequence digits = null;
    boolean phone = false;
    boolean autotext = false;
    int autocap = -1;
    int buffertype = 0;
    boolean selectallonfocus = false;
    Drawable drawableLeft = null, drawableTop = null, drawableRight = null,
      drawableBottom = null, drawableStart = null, drawableEnd = null;
    ColorStateList drawableTint = null;
    BlendMode drawableTintMode = null;
    int drawablePadding = 0;
    int ellipsize = ELLIPSIZE_NOT_SET;
    boolean singleLine = false;
    int maxlength = -1;
    CharSequence text = "";
    CharSequence hint = null;
    boolean password = false;
    float autoSizeMinTextSizeInPx = UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE;
    float autoSizeMaxTextSizeInPx = UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE;
    float autoSizeStepGranularityInPx = UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE;
    int inputType = EditorInfo.TYPE_NULL;
    a = theme.obtainStyledAttributes(
      attrs, com.android.internal.R.styleable.TextView, defStyleAttr, defStyleRes);
    saveAttributeDataForStyleable(context, com.android.internal.R.styleable.TextView, attrs, a,
                                  defStyleAttr, defStyleRes);
    int firstBaselineToTopHeight = -1;
    int lastBaselineToBottomHeight = -1;
    float lineHeight = -1f;
    int lineHeightUnit = -1;
    boolean hasUseBoundForWidthValue = false;

    readTextAppearance(context, a, attributes, true /* styleArray */);

    int n = a.getIndexCount();

    // Must set id in a temporary variable because it will be reset by setText()
    boolean textIsSetFromXml = false;
    for (int i = 0; i < n; i++) {
      int attr = a.getIndex(i);

      switch (attr) {
        case com.android.internal.R.styleable.TextView_editable:
          editable = a.getBoolean(attr, editable);
          break;

        case com.android.internal.R.styleable.TextView_inputMethod:
          inputMethod = a.getText(attr);
          break;

        case com.android.internal.R.styleable.TextView_numeric:
          numeric = a.getInt(attr, numeric);
          break;

        case com.android.internal.R.styleable.TextView_digits:
          digits = a.getText(attr);
          break;

        case com.android.internal.R.styleable.TextView_phoneNumber:
          phone = a.getBoolean(attr, phone);
          break;

        case com.android.internal.R.styleable.TextView_autoText:
          autotext = a.getBoolean(attr, autotext);
          break;

        case com.android.internal.R.styleable.TextView_capitalize:
          autocap = a.getInt(attr, autocap);
          break;

        case com.android.internal.R.styleable.TextView_bufferType:
          buffertype = a.getInt(attr, buffertype);
          break;

        case com.android.internal.R.styleable.TextView_selectAllOnFocus:
          selectallonfocus = a.getBoolean(attr, selectallonfocus);
          break;

        case com.android.internal.R.styleable.TextView_autoLink:
          mAutoLinkMask = a.getInt(attr, 0);
          break;

        case com.android.internal.R.styleable.TextView_linksClickable:
          mLinksClickable = a.getBoolean(attr, true);
          break;

        case com.android.internal.R.styleable.TextView_drawableLeft:
          drawableLeft = a.getDrawable(attr);
          break;

        case com.android.internal.R.styleable.TextView_drawableTop:
          drawableTop = a.getDrawable(attr);
          break;

        case com.android.internal.R.styleable.TextView_drawableRight:
          drawableRight = a.getDrawable(attr);
          break;

        case com.android.internal.R.styleable.TextView_drawableBottom:
          drawableBottom = a.getDrawable(attr);
          break;

        case com.android.internal.R.styleable.TextView_drawableStart:
          drawableStart = a.getDrawable(attr);
          break;

        case com.android.internal.R.styleable.TextView_drawableEnd:
          drawableEnd = a.getDrawable(attr);
          break;

        case com.android.internal.R.styleable.TextView_drawableTint:
          drawableTint = a.getColorStateList(attr);
          break;

        case com.android.internal.R.styleable.TextView_drawableTintMode:
          drawableTintMode = Drawable.parseBlendMode(a.getInt(attr, -1),
                                                     drawableTintMode);
          break;

        case com.android.internal.R.styleable.TextView_drawablePadding:
          drawablePadding = a.getDimensionPixelSize(attr, drawablePadding);
          break;

        case com.android.internal.R.styleable.TextView_maxLines:
          setMaxLines(a.getInt(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_maxHeight:
          setMaxHeight(a.getDimensionPixelSize(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_lines:
          setLines(a.getInt(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_height:
          setHeight(a.getDimensionPixelSize(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_minLines:
          setMinLines(a.getInt(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_minHeight:
          setMinHeight(a.getDimensionPixelSize(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_maxEms:
          setMaxEms(a.getInt(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_maxWidth:
          setMaxWidth(a.getDimensionPixelSize(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_ems:
          setEms(a.getInt(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_width:
          setWidth(a.getDimensionPixelSize(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_minEms:
          setMinEms(a.getInt(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_minWidth:
          setMinWidth(a.getDimensionPixelSize(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_gravity:
          setGravity(a.getInt(attr, -1));
          break;

        case com.android.internal.R.styleable.TextView_hint:
          mHintId = a.getResourceId(attr, Resources.ID_NULL);
          hint = a.getText(attr);
          break;

        case com.android.internal.R.styleable.TextView_text:
          textIsSetFromXml = true;
          mTextId = a.getResourceId(attr, Resources.ID_NULL);
          text = a.getText(attr);
          break;

        case com.android.internal.R.styleable.TextView_scrollHorizontally:
          if (a.getBoolean(attr, false)) {
            setHorizontallyScrolling(true);
          }
          break;

        case com.android.internal.R.styleable.TextView_singleLine:
          singleLine = a.getBoolean(attr, singleLine);
          break;

        case com.android.internal.R.styleable.TextView_ellipsize:
          ellipsize = a.getInt(attr, ellipsize);
          break;

        case com.android.internal.R.styleable.TextView_marqueeRepeatLimit:
          setMarqueeRepeatLimit(a.getInt(attr, mMarqueeRepeatLimit));
          break;

        case com.android.internal.R.styleable.TextView_includeFontPadding:
          if (!a.getBoolean(attr, true)) {
            setIncludeFontPadding(false);
          }
          break;

        case com.android.internal.R.styleable.TextView_cursorVisible:
          if (!a.getBoolean(attr, true)) {
            setCursorVisible(false);
          }
          break;

        case com.android.internal.R.styleable.TextView_maxLength:
          maxlength = a.getInt(attr, -1);
          break;

        case com.android.internal.R.styleable.TextView_textScaleX:
          setTextScaleX(a.getFloat(attr, 1.0f));
          break;

        case com.android.internal.R.styleable.TextView_freezesText:
          mFreezesText = a.getBoolean(attr, false);
          break;

        case com.android.internal.R.styleable.TextView_enabled:
          setEnabled(a.getBoolean(attr, isEnabled()));
          break;

        case com.android.internal.R.styleable.TextView_password:
          password = a.getBoolean(attr, password);
          break;

        case com.android.internal.R.styleable.TextView_lineSpacingExtra:
          mSpacingAdd = a.getDimensionPixelSize(attr, (int) mSpacingAdd);
          break;

        case com.android.internal.R.styleable.TextView_lineSpacingMultiplier:
          mSpacingMult = a.getFloat(attr, mSpacingMult);
          break;

        case com.android.internal.R.styleable.TextView_inputType:
          inputType = a.getInt(attr, EditorInfo.TYPE_NULL);
          break;

        case com.android.internal.R.styleable.TextView_allowUndo:
          createEditorIfNeeded();
          mEditor.mAllowUndo = a.getBoolean(attr, true);
          break;

        case com.android.internal.R.styleable.TextView_imeOptions:
          createEditorIfNeeded();
          mEditor.createInputContentTypeIfNeeded();
          mEditor.mInputContentType.imeOptions = a.getInt(attr,
                                                          mEditor.mInputContentType.imeOptions);
          break;

        case com.android.internal.R.styleable.TextView_imeActionLabel:
          createEditorIfNeeded();
          mEditor.createInputContentTypeIfNeeded();
          mEditor.mInputContentType.imeActionLabel = a.getText(attr);
          break;

        case com.android.internal.R.styleable.TextView_imeActionId:
          createEditorIfNeeded();
          mEditor.createInputContentTypeIfNeeded();
          mEditor.mInputContentType.imeActionId = a.getInt(attr,
                                                           mEditor.mInputContentType.imeActionId);
          break;

        case com.android.internal.R.styleable.TextView_privateImeOptions:
          setPrivateImeOptions(a.getString(attr));
          break;

        case com.android.internal.R.styleable.TextView_editorExtras:
          try {
            setInputExtras(a.getResourceId(attr, 0));
          } catch (XmlPullParserException e) {
            Log.w(LOG_TAG, "Failure reading input extras", e);
          } catch (IOException e) {
            Log.w(LOG_TAG, "Failure reading input extras", e);
          }
          break;

        case com.android.internal.R.styleable.TextView_textCursorDrawable:
          mCursorDrawableRes = a.getResourceId(attr, 0);
          break;

        case com.android.internal.R.styleable.TextView_textSelectHandleLeft:
          mTextSelectHandleLeftRes = a.getResourceId(attr, 0);
          break;

        case com.android.internal.R.styleable.TextView_textSelectHandleRight:
          mTextSelectHandleRightRes = a.getResourceId(attr, 0);
          break;

        case com.android.internal.R.styleable.TextView_textSelectHandle:
          mTextSelectHandleRes = a.getResourceId(attr, 0);
          break;

        case com.android.internal.R.styleable.TextView_textEditSuggestionItemLayout:
          mTextEditSuggestionItemLayout = a.getResourceId(attr, 0);
          break;

        case com.android.internal.R.styleable.TextView_textEditSuggestionContainerLayout:
          mTextEditSuggestionContainerLayout = a.getResourceId(attr, 0);
          break;

        case com.android.internal.R.styleable.TextView_textEditSuggestionHighlightStyle:
          mTextEditSuggestionHighlightStyle = a.getResourceId(attr, 0);
          break;

        case com.android.internal.R.styleable.TextView_textIsSelectable:
          setTextIsSelectable(a.getBoolean(attr, false));
          break;

        case com.android.internal.R.styleable.TextView_breakStrategy:
          mBreakStrategy = a.getInt(attr, Layout.BREAK_STRATEGY_SIMPLE);
          break;

        case com.android.internal.R.styleable.TextView_hyphenationFrequency:
          mHyphenationFrequency = a.getInt(attr, Layout.HYPHENATION_FREQUENCY_NONE);
          break;

        case com.android.internal.R.styleable.TextView_lineBreakStyle:
          mLineBreakStyle = a.getInt(attr, LineBreakConfig.LINE_BREAK_STYLE_NONE);
          break;

        case com.android.internal.R.styleable.TextView_lineBreakWordStyle:
          mLineBreakWordStyle = a.getInt(attr,
                                         LineBreakConfig.LINE_BREAK_WORD_STYLE_NONE);
          break;

        case com.android.internal.R.styleable.TextView_autoSizeTextType:
          mAutoSizeTextType = a.getInt(attr, AUTO_SIZE_TEXT_TYPE_NONE);
          break;

        case com.android.internal.R.styleable.TextView_autoSizeStepGranularity:
          autoSizeStepGranularityInPx = a.getDimension(attr,
                                                       UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE);
          break;

        case com.android.internal.R.styleable.TextView_autoSizeMinTextSize:
          autoSizeMinTextSizeInPx = a.getDimension(attr,
                                                   UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE);
          break;

        case com.android.internal.R.styleable.TextView_autoSizeMaxTextSize:
          autoSizeMaxTextSizeInPx = a.getDimension(attr,
                                                   UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE);
          break;

        case com.android.internal.R.styleable.TextView_autoSizePresetSizes:
          final int autoSizeStepSizeArrayResId = a.getResourceId(attr, 0);
          if (autoSizeStepSizeArrayResId > 0) {
            final TypedArray autoSizePresetTextSizes = a.getResources()
              .obtainTypedArray(autoSizeStepSizeArrayResId);
            setupAutoSizeUniformPresetSizes(autoSizePresetTextSizes);
            autoSizePresetTextSizes.recycle();
          }
          break;
        case com.android.internal.R.styleable.TextView_justificationMode:
          mJustificationMode = a.getInt(attr, Layout.JUSTIFICATION_MODE_NONE);
          break;

        case com.android.internal.R.styleable.TextView_firstBaselineToTopHeight:
          firstBaselineToTopHeight = a.getDimensionPixelSize(attr, -1);
          break;

        case com.android.internal.R.styleable.TextView_lastBaselineToBottomHeight:
          lastBaselineToBottomHeight = a.getDimensionPixelSize(attr, -1);
          break;

        case com.android.internal.R.styleable.TextView_lineHeight:
          TypedValue peekValue = a.peekValue(attr);
          if (peekValue != null && peekValue.type == TypedValue.TYPE_DIMENSION) {
            lineHeightUnit = peekValue.getComplexUnit();
            lineHeight = TypedValue.complexToFloat(peekValue.data);
          } else {
            lineHeight = a.getDimensionPixelSize(attr, -1);
          }
          break;
        case com.android.internal.R.styleable.TextView_useBoundsForWidth:
          mUseBoundsForWidth = a.getBoolean(attr, false);
          hasUseBoundForWidthValue = true;
          break;
        case com.android.internal.R.styleable
               .TextView_shiftDrawingOffsetForStartOverhang:
          mShiftDrawingOffsetForStartOverhang = a.getBoolean(attr, false);
          break;
        case com.android.internal.R.styleable
               .TextView_useLocalePreferredLineHeightForMinimum:
          mUseLocalePreferredLineHeightForMinimum = a.getBoolean(attr, false);
          break;
      }
    }

    a.recycle();

    BufferType bufferType = BufferType.EDITABLE;

    final int variation =
      inputType & (EditorInfo.TYPE_MASK_CLASS | EditorInfo.TYPE_MASK_VARIATION);
    final boolean passwordInputType = variation
                                      == (EditorInfo.TYPE_CLASS_TEXT | EditorInfo.TYPE_TEXT_VARIATION_PASSWORD);
    final boolean webPasswordInputType = variation
                                         == (EditorInfo.TYPE_CLASS_TEXT | EditorInfo.TYPE_TEXT_VARIATION_WEB_PASSWORD);
    final boolean numberPasswordInputType = variation
                                            == (EditorInfo.TYPE_CLASS_NUMBER | EditorInfo.TYPE_NUMBER_VARIATION_PASSWORD);

    final int targetSdkVersion = context.getApplicationInfo().targetSdkVersion;
    mUseInternationalizedInput = targetSdkVersion >= VERSION_CODES.O;
    if (CompatChanges.isChangeEnabled(BORINGLAYOUT_FALLBACK_LINESPACING)) {
      mUseFallbackLineSpacing = FALLBACK_LINE_SPACING_ALL;
    } else if (CompatChanges.isChangeEnabled(STATICLAYOUT_FALLBACK_LINESPACING)) {
      mUseFallbackLineSpacing = FALLBACK_LINE_SPACING_STATIC_LAYOUT_ONLY;
    } else {
      mUseFallbackLineSpacing = FALLBACK_LINE_SPACING_NONE;
    }

    if (!hasUseBoundForWidthValue) {
      if (CompatChanges.isChangeEnabled(USE_BOUNDS_FOR_WIDTH)) {
        mUseBoundsForWidth = ClientFlags.useBoundsForWidth();
      } else {
        mUseBoundsForWidth = false;
      }
    }

    // TODO(b/179693024): Use a ChangeId instead.
    mUseTextPaddingForUiTranslation = targetSdkVersion <= Build.VERSION_CODES.R;

    if (inputMethod != null) {
      Class<?> c;

      try {
        c = Class.forName(inputMethod.toString());
      } catch (ClassNotFoundException ex) {
        throw new RuntimeException(ex);
      }

      try {
        createEditorIfNeeded();
        mEditor.mKeyListener = (KeyListener) c.newInstance();
      } catch (InstantiationException ex) {
        throw new RuntimeException(ex);
      } catch (IllegalAccessException ex) {
        throw new RuntimeException(ex);
      }
      try {
        mEditor.mInputType = inputType != EditorInfo.TYPE_NULL
                             ? inputType
                             : mEditor.mKeyListener.getInputType();
      } catch (IncompatibleClassChangeError e) {
        mEditor.mInputType = EditorInfo.TYPE_CLASS_TEXT;
      }
    } else if (digits != null) {
      createEditorIfNeeded();
      mEditor.mKeyListener = DigitsKeyListener.getInstance(digits.toString());
      // If no input type was specified, we will default to generic
      // text, since we can't tell the IME about the set of digits
      // that was selected.
      mEditor.mInputType = inputType != EditorInfo.TYPE_NULL
                           ? inputType : EditorInfo.TYPE_CLASS_TEXT;
    } else if (inputType != EditorInfo.TYPE_NULL) {
      setInputType(inputType, true);
      // If set, the input type overrides what was set using the deprecated singleLine flag.
      singleLine = !isMultilineInputType(inputType);
    } else if (phone) {
      createEditorIfNeeded();
      mEditor.mKeyListener = DialerKeyListener.getInstance();
      mEditor.mInputType = inputType = EditorInfo.TYPE_CLASS_PHONE;
    } else if (numeric != 0) {
      createEditorIfNeeded();
      mEditor.mKeyListener = DigitsKeyListener.getInstance(
        null,  // locale
        (numeric & SIGNED) != 0,
        (numeric & DECIMAL) != 0);
      inputType = mEditor.mKeyListener.getInputType();
      mEditor.mInputType = inputType;
    } else if (autotext || autocap != -1) {
      TextKeyListener.Capitalize cap;

      inputType = EditorInfo.TYPE_CLASS_TEXT;

      switch (autocap) {
        case 1:
          cap = TextKeyListener.Capitalize.SENTENCES;
          inputType |= EditorInfo.TYPE_TEXT_FLAG_CAP_SENTENCES;
          break;

        case 2:
          cap = TextKeyListener.Capitalize.WORDS;
          inputType |= EditorInfo.TYPE_TEXT_FLAG_CAP_WORDS;
          break;

        case 3:
          cap = TextKeyListener.Capitalize.CHARACTERS;
          inputType |= EditorInfo.TYPE_TEXT_FLAG_CAP_CHARACTERS;
          break;

        default:
          cap = TextKeyListener.Capitalize.NONE;
          break;
      }

      createEditorIfNeeded();
      mEditor.mKeyListener = TextKeyListener.getInstance(autotext, cap);
      mEditor.mInputType = inputType;
    } else if (editable) {
      createEditorIfNeeded();
      mEditor.mKeyListener = TextKeyListener.getInstance();
      mEditor.mInputType = EditorInfo.TYPE_CLASS_TEXT;
    } else if (isTextSelectable()) {
      // Prevent text changes from keyboard.
      if (mEditor != null) {
        mEditor.mKeyListener = null;
        mEditor.mInputType = EditorInfo.TYPE_NULL;
      }
      bufferType = BufferType.SPANNABLE;
      // So that selection can be changed using arrow keys and touch is handled.
      setMovementMethod(ArrowKeyMovementMethod.getInstance());
    } else {
      if (mEditor != null) mEditor.mKeyListener = null;

      switch (buffertype) {
        case 0:
          bufferType = BufferType.NORMAL;
          break;
        case 1:
          bufferType = BufferType.SPANNABLE;
          break;
        case 2:
          bufferType = BufferType.EDITABLE;
          break;
      }
    }

    if (mEditor != null) {
      mEditor.adjustInputType(password, passwordInputType, webPasswordInputType,
                              numberPasswordInputType);
    }

    if (selectallonfocus) {
      createEditorIfNeeded();
      mEditor.mSelectAllOnFocus = true;

      if (bufferType == BufferType.NORMAL) {
        bufferType = BufferType.SPANNABLE;
      }
    }

    // Set up the tint (if needed) before setting the drawables so that it
    // gets applied correctly.
    if (drawableTint != null || drawableTintMode != null) {
      if (mDrawables == null) {
        mDrawables = new Drawables(context);
      }
      if (drawableTint != null) {
        mDrawables.mTintList = drawableTint;
        mDrawables.mHasTint = true;
      }
      if (drawableTintMode != null) {
        mDrawables.mBlendMode = drawableTintMode;
        mDrawables.mHasTintMode = true;
      }
    }

    // This call will save the initial left/right drawables
    setCompoundDrawablesWithIntrinsicBounds(
      drawableLeft, drawableTop, drawableRight, drawableBottom);
    setRelativeDrawablesIfNeeded(drawableStart, drawableEnd);
    setCompoundDrawablePadding(drawablePadding);

    // Same as setSingleLine(), but make sure the transformation method and the maximum number
    // of lines of height are unchanged for multi-line TextViews.
    setInputTypeSingleLine(singleLine);
    applySingleLine(singleLine, singleLine, singleLine,
                    // Does not apply automated max length filter since length filter will be resolved
                    // later in this function.
                    false
    );

    if (singleLine && getKeyListener() == null && ellipsize == ELLIPSIZE_NOT_SET) {
      ellipsize = ELLIPSIZE_END;
    }

    switch (ellipsize) {
      case ELLIPSIZE_START:
        setEllipsize(TextUtils.TruncateAt.START);
        break;
      case ELLIPSIZE_MIDDLE:
        setEllipsize(TextUtils.TruncateAt.MIDDLE);
        break;
      case ELLIPSIZE_END:
        setEllipsize(TextUtils.TruncateAt.END);
        break;
      case ELLIPSIZE_MARQUEE:
        if (ViewConfiguration.get(context).isFadingMarqueeEnabled()) {
          setHorizontalFadingEdgeEnabled(true);
          mMarqueeFadeMode = MARQUEE_FADE_NORMAL;
        } else {
          setHorizontalFadingEdgeEnabled(false);
          mMarqueeFadeMode = MARQUEE_FADE_SWITCH_SHOW_ELLIPSIS;
        }
        setEllipsize(TextUtils.TruncateAt.MARQUEE);
        break;
    }

    final boolean isPassword = password || passwordInputType || webPasswordInputType
                               || numberPasswordInputType;
    final boolean isMonospaceEnforced = isPassword || (mEditor != null
                                                       && (mEditor.mInputType
                                                           & (EditorInfo.TYPE_MASK_CLASS | EditorInfo.TYPE_MASK_VARIATION))
                                                          == (EditorInfo.TYPE_CLASS_TEXT | EditorInfo.TYPE_TEXT_VARIATION_PASSWORD));
    if (isMonospaceEnforced) {
      attributes.mTypefaceIndex = MONOSPACE;
    }

    mFontWeightAdjustment = getContext().getResources().getConfiguration().fontWeightAdjustment;
    applyTextAppearance(attributes);

    if (isPassword) {
      setTransformationMethod(PasswordTransformationMethod.getInstance());
    }

    // For addressing b/145128646
    // For the performance reason, we limit characters for single line text field.
    if (bufferType == BufferType.EDITABLE && singleLine && maxlength == -1) {
      mSingleLineLengthFilter = new InputFilter.LengthFilter(
        MAX_LENGTH_FOR_SINGLE_LINE_EDIT_TEXT);
    }

    if (mSingleLineLengthFilter != null) {
      setFilters(new InputFilter[] { mSingleLineLengthFilter });
    } else if (maxlength >= 0) {
      setFilters(new InputFilter[] { new InputFilter.LengthFilter(maxlength) });
    } else {
      setFilters(NO_FILTERS);
    }

    setText(text, bufferType);
    if (mText == null) {
      mText = "";
    }
    if (mTransformed == null) {
      mTransformed = "";
    }

    if (textIsSetFromXml) {
      mTextSetFromXmlOrResourceId = true;
    }

    if (hint != null) setHint(hint);

    /*
     * Views are not normally clickable unless specified to be.
     * However, TextViews that have input or movement methods *are*
     * clickable by default. By setting clickable here, we implicitly set focusable as well
     * if not overridden by the developer.
     */
    a = context.obtainStyledAttributes(
      attrs, com.android.internal.R.styleable.View, defStyleAttr, defStyleRes);
    boolean canInputOrMove = (mMovement != null || getKeyListener() != null);
    boolean clickable = canInputOrMove || isClickable();
    boolean longClickable = canInputOrMove || isLongClickable();
    int focusable = getFocusable();
    boolean isAutoHandwritingEnabled = true;

    n = a.getIndexCount();
    for (int i = 0; i < n; i++) {
      int attr = a.getIndex(i);

      switch (attr) {
        case com.android.internal.R.styleable.View_focusable:
          TypedValue val = new TypedValue();
          if (a.getValue(attr, val)) {
            focusable = (val.type == TypedValue.TYPE_INT_BOOLEAN)
                        ? (val.data == 0 ? NOT_FOCUSABLE : FOCUSABLE)
                        : val.data;
          }
          break;

        case com.android.internal.R.styleable.View_clickable:
          clickable = a.getBoolean(attr, clickable);
          break;

        case com.android.internal.R.styleable.View_longClickable:
          longClickable = a.getBoolean(attr, longClickable);
          break;

        case com.android.internal.R.styleable.View_autoHandwritingEnabled:
          isAutoHandwritingEnabled = a.getBoolean(attr, true);
          break;
      }
    }
    a.recycle();

    // Some apps were relying on the undefined behavior of focusable winning over
    // focusableInTouchMode != focusable in TextViews if both were specified in XML (usually
    // when starting with EditText and setting only focusable=false). To keep those apps from
    // breaking, re-apply the focusable attribute here.
    if (focusable != getFocusable()) {
      setFocusable(focusable);
    }
    setClickable(clickable);
    setLongClickable(longClickable);
    setAutoHandwritingEnabled(isAutoHandwritingEnabled);

    if (mEditor != null) mEditor.prepareCursorControllers();

    // If not explicitly specified this view is important for accessibility.
    if (getImportantForAccessibility() == IMPORTANT_FOR_ACCESSIBILITY_AUTO) {
      setImportantForAccessibility(IMPORTANT_FOR_ACCESSIBILITY_YES);
    }

    if (supportsAutoSizeText()) {
      if (mAutoSizeTextType == AUTO_SIZE_TEXT_TYPE_UNIFORM) {
        // If uniform auto-size has been specified but preset values have not been set then
        // replace the auto-size configuration values that have not been specified with the
        // defaults.
        if (!mHasPresetAutoSizeValues) {
          final DisplayMetrics displayMetrics = getResources().getDisplayMetrics();

          if (autoSizeMinTextSizeInPx == UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE) {
            autoSizeMinTextSizeInPx = TypedValue.applyDimension(
              TypedValue.COMPLEX_UNIT_SP,
              DEFAULT_AUTO_SIZE_MIN_TEXT_SIZE_IN_SP,
              displayMetrics);
          }

          if (autoSizeMaxTextSizeInPx == UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE) {
            autoSizeMaxTextSizeInPx = TypedValue.applyDimension(
              TypedValue.COMPLEX_UNIT_SP,
              DEFAULT_AUTO_SIZE_MAX_TEXT_SIZE_IN_SP,
              displayMetrics);
          }

          if (autoSizeStepGranularityInPx
              == UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE) {
            autoSizeStepGranularityInPx = DEFAULT_AUTO_SIZE_GRANULARITY_IN_PX;
          }

          validateAndSetAutoSizeTextTypeUniformConfiguration(autoSizeMinTextSizeInPx,
                                                             autoSizeMaxTextSizeInPx,
                                                             autoSizeStepGranularityInPx);
        }

        setupAutoSizeText();
      }
    } else {
      mAutoSizeTextType = AUTO_SIZE_TEXT_TYPE_NONE;
    }

    if (firstBaselineToTopHeight >= 0) {
      setFirstBaselineToTopHeight(firstBaselineToTopHeight);
    }
    if (lastBaselineToBottomHeight >= 0) {
      setLastBaselineToBottomHeight(lastBaselineToBottomHeight);
    }
    if (lineHeight >= 0) {
      if (lineHeightUnit == -1) {
        setLineHeightPx(lineHeight);
      } else {
        setLineHeight(lineHeightUnit, lineHeight);
      }
    }
  }

  // Update mText and mPrecomputed
  private void setTextInternal(@Nullable CharSequence text) {
    mText = text;
    mSpannable = (text instanceof Spannable) ? (Spannable) text : null;
    mPrecomputed = (text instanceof PrecomputedText) ? (PrecomputedText) text : null;
  }

  /**
   * Specify whether this widget should automatically scale the text to try to perfectly fit
   * within the layout bounds by using the default auto-size configuration.
   *
   * @param autoSizeTextType the type of auto-size. Must be one of
   *        {@link TextView#AUTO_SIZE_TEXT_TYPE_NONE} or
   *        {@link TextView#AUTO_SIZE_TEXT_TYPE_UNIFORM}
   *
   * @throws IllegalArgumentException if <code>autoSizeTextType</code> is none of the types above.
   *
   * @attr ref android.R.styleable#TextView_autoSizeTextType
   *
   * @see #getAutoSizeTextType()
   */
  public void setAutoSizeTextTypeWithDefaults(@AutoSizeTextType int autoSizeTextType) {
    if (supportsAutoSizeText()) {
      switch (autoSizeTextType) {
        case AUTO_SIZE_TEXT_TYPE_NONE:
          clearAutoSizeConfiguration();
          break;
        case AUTO_SIZE_TEXT_TYPE_UNIFORM:
          final DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
          final float autoSizeMinTextSizeInPx = TypedValue.applyDimension(
            TypedValue.COMPLEX_UNIT_SP,
            DEFAULT_AUTO_SIZE_MIN_TEXT_SIZE_IN_SP,
            displayMetrics);
          final float autoSizeMaxTextSizeInPx = TypedValue.applyDimension(
            TypedValue.COMPLEX_UNIT_SP,
            DEFAULT_AUTO_SIZE_MAX_TEXT_SIZE_IN_SP,
            displayMetrics);

          validateAndSetAutoSizeTextTypeUniformConfiguration(
            autoSizeMinTextSizeInPx,
            autoSizeMaxTextSizeInPx,
            DEFAULT_AUTO_SIZE_GRANULARITY_IN_PX);
          if (setupAutoSizeText()) {
            autoSizeText();
            invalidate();
          }
          break;
        default:
          throw new IllegalArgumentException(
            "Unknown auto-size text type: " + autoSizeTextType);
      }
    }
  }

  /**
   * Specify whether this widget should automatically scale the text to try to perfectly fit
   * within the layout bounds. If all the configuration params are valid the type of auto-size is
   * set to {@link #AUTO_SIZE_TEXT_TYPE_UNIFORM}.
   *
   * @param autoSizeMinTextSize the minimum text size available for auto-size
   * @param autoSizeMaxTextSize the maximum text size available for auto-size
   * @param autoSizeStepGranularity the auto-size step granularity. It is used in conjunction with
   *                                the minimum and maximum text size in order to build the set of
   *                                text sizes the system uses to choose from when auto-sizing
   * @param unit the desired dimension unit for all sizes above. See {@link TypedValue} for the
   *             possible dimension units
   *
   * @throws IllegalArgumentException if any of the configuration params are invalid.
   *
   * @attr ref android.R.styleable#TextView_autoSizeTextType
   * @attr ref android.R.styleable#TextView_autoSizeMinTextSize
   * @attr ref android.R.styleable#TextView_autoSizeMaxTextSize
   * @attr ref android.R.styleable#TextView_autoSizeStepGranularity
   *
   * @see #setAutoSizeTextTypeWithDefaults(int)
   * @see #setAutoSizeTextTypeUniformWithPresetSizes(int[], int)
   * @see #getAutoSizeMinTextSize()
   * @see #getAutoSizeMaxTextSize()
   * @see #getAutoSizeStepGranularity()
   * @see #getAutoSizeTextAvailableSizes()
   */
  public void setAutoSizeTextTypeUniformWithConfiguration(int autoSizeMinTextSize,
                                                          int autoSizeMaxTextSize, int autoSizeStepGranularity, int unit) {
    if (supportsAutoSizeText()) {
      final DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
      final float autoSizeMinTextSizeInPx = TypedValue.applyDimension(
        unit, autoSizeMinTextSize, displayMetrics);
      final float autoSizeMaxTextSizeInPx = TypedValue.applyDimension(
        unit, autoSizeMaxTextSize, displayMetrics);
      final float autoSizeStepGranularityInPx = TypedValue.applyDimension(
        unit, autoSizeStepGranularity, displayMetrics);

      validateAndSetAutoSizeTextTypeUniformConfiguration(autoSizeMinTextSizeInPx,
                                                         autoSizeMaxTextSizeInPx,
                                                         autoSizeStepGranularityInPx);

      if (setupAutoSizeText()) {
        autoSizeText();
        invalidate();
      }
    }
  }

  /**
   * Specify whether this widget should automatically scale the text to try to perfectly fit
   * within the layout bounds. If at least one value from the <code>presetSizes</code> is valid
   * then the type of auto-size is set to {@link #AUTO_SIZE_TEXT_TYPE_UNIFORM}.
   *
   * @param presetSizes an {@code int} array of sizes in pixels
   * @param unit the desired dimension unit for the preset sizes above. See {@link TypedValue} for
   *             the possible dimension units
   *
   * @throws IllegalArgumentException if all of the <code>presetSizes</code> are invalid.
   *
   * @attr ref android.R.styleable#TextView_autoSizeTextType
   * @attr ref android.R.styleable#TextView_autoSizePresetSizes
   *
   * @see #setAutoSizeTextTypeWithDefaults(int)
   * @see #setAutoSizeTextTypeUniformWithConfiguration(int, int, int, int)
   * @see #getAutoSizeMinTextSize()
   * @see #getAutoSizeMaxTextSize()
   * @see #getAutoSizeTextAvailableSizes()
   */
  public void setAutoSizeTextTypeUniformWithPresetSizes(@NonNull int[] presetSizes, int unit) {
    if (supportsAutoSizeText()) {
      final int presetSizesLength = presetSizes.length;
      if (presetSizesLength > 0) {
        int[] presetSizesInPx = new int[presetSizesLength];

        if (unit == TypedValue.COMPLEX_UNIT_PX) {
          presetSizesInPx = Arrays.copyOf(presetSizes, presetSizesLength);
        } else {
          final DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
          // Convert all to sizes to pixels.
          for (int i = 0; i < presetSizesLength; i++) {
            presetSizesInPx[i] = Math.round(TypedValue.applyDimension(unit,
                                                                      presetSizes[i], displayMetrics));
          }
        }

        mAutoSizeTextSizesInPx = cleanupAutoSizePresetSizes(presetSizesInPx);
        if (!setupAutoSizeUniformPresetSizesConfiguration()) {
          throw new IllegalArgumentException("None of the preset sizes is valid: "
                                             + Arrays.toString(presetSizes));
        }
      } else {
        mHasPresetAutoSizeValues = false;
      }

      if (setupAutoSizeText()) {
        autoSizeText();
        invalidate();
      }
    }
  }

  /**
   * Returns the type of auto-size set for this widget.
   *
   * @return an {@code int} corresponding to one of the auto-size types:
   *         {@link TextView#AUTO_SIZE_TEXT_TYPE_NONE} or
   *         {@link TextView#AUTO_SIZE_TEXT_TYPE_UNIFORM}
   *
   * @attr ref android.R.styleable#TextView_autoSizeTextType
   *
   * @see #setAutoSizeTextTypeWithDefaults(int)
   * @see #setAutoSizeTextTypeUniformWithConfiguration(int, int, int, int)
   * @see #setAutoSizeTextTypeUniformWithPresetSizes(int[], int)
   */
  @InspectableProperty(enumMapping = {
    @EnumEntry(name = "none", value = AUTO_SIZE_TEXT_TYPE_NONE),
    @EnumEntry(name = "uniform", value = AUTO_SIZE_TEXT_TYPE_UNIFORM)
  })
  @AutoSizeTextType
  public int getAutoSizeTextType() {
    return mAutoSizeTextType;
  }

  /**
   * @return the current auto-size step granularity in pixels.
   *
   * @attr ref android.R.styleable#TextView_autoSizeStepGranularity
   *
   * @see #setAutoSizeTextTypeUniformWithConfiguration(int, int, int, int)
   */
  @InspectableProperty
  public int getAutoSizeStepGranularity() {
    return Math.round(mAutoSizeStepGranularityInPx);
  }

  /**
   * @return the current auto-size minimum text size in pixels (the default is 12sp). Note that
   *         if auto-size has not been configured this function returns {@code -1}.
   *
   * @attr ref android.R.styleable#TextView_autoSizeMinTextSize
   *
   * @see #setAutoSizeTextTypeUniformWithConfiguration(int, int, int, int)
   * @see #setAutoSizeTextTypeUniformWithPresetSizes(int[], int)
   */
  @InspectableProperty
  public int getAutoSizeMinTextSize() {
    return Math.round(mAutoSizeMinTextSizeInPx);
  }

  /**
   * @return the current auto-size maximum text size in pixels (the default is 112sp). Note that
   *         if auto-size has not been configured this function returns {@code -1}.
   *
   * @attr ref android.R.styleable#TextView_autoSizeMaxTextSize
   *
   * @see #setAutoSizeTextTypeUniformWithConfiguration(int, int, int, int)
   * @see #setAutoSizeTextTypeUniformWithPresetSizes(int[], int)
   */
  @InspectableProperty
  public int getAutoSizeMaxTextSize() {
    return Math.round(mAutoSizeMaxTextSizeInPx);
  }

  /**
   * @return the current auto-size {@code int} sizes array (in pixels).
   *
   * @see #setAutoSizeTextTypeUniformWithConfiguration(int, int, int, int)
   * @see #setAutoSizeTextTypeUniformWithPresetSizes(int[], int)
   */
  public int[] getAutoSizeTextAvailableSizes() {
    return mAutoSizeTextSizesInPx;
  }

  private void setupAutoSizeUniformPresetSizes(TypedArray textSizes) {
    final int textSizesLength = textSizes.length();
    final int[] parsedSizes = new int[textSizesLength];

    if (textSizesLength > 0) {
      for (int i = 0; i < textSizesLength; i++) {
        parsedSizes[i] = textSizes.getDimensionPixelSize(i, -1);
      }
      mAutoSizeTextSizesInPx = cleanupAutoSizePresetSizes(parsedSizes);
      setupAutoSizeUniformPresetSizesConfiguration();
    }
  }

  private boolean setupAutoSizeUniformPresetSizesConfiguration() {
    final int sizesLength = mAutoSizeTextSizesInPx.length;
    mHasPresetAutoSizeValues = sizesLength > 0;
    if (mHasPresetAutoSizeValues) {
      mAutoSizeTextType = AUTO_SIZE_TEXT_TYPE_UNIFORM;
      mAutoSizeMinTextSizeInPx = mAutoSizeTextSizesInPx[0];
      mAutoSizeMaxTextSizeInPx = mAutoSizeTextSizesInPx[sizesLength - 1];
      mAutoSizeStepGranularityInPx = UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE;
    }
    return mHasPresetAutoSizeValues;
  }

  /**
   * If all params are valid then save the auto-size configuration.
   *
   * @throws IllegalArgumentException if any of the params are invalid
   */
  private void validateAndSetAutoSizeTextTypeUniformConfiguration(float autoSizeMinTextSizeInPx,
                                                                  float autoSizeMaxTextSizeInPx, float autoSizeStepGranularityInPx) {
    // First validate.
    if (autoSizeMinTextSizeInPx <= 0) {
      throw new IllegalArgumentException("Minimum auto-size text size ("
                                         + autoSizeMinTextSizeInPx  + "px) is less or equal to (0px)");
    }

    if (autoSizeMaxTextSizeInPx <= autoSizeMinTextSizeInPx) {
      throw new IllegalArgumentException("Maximum auto-size text size ("
                                         + autoSizeMaxTextSizeInPx + "px) is less or equal to minimum auto-size "
                                         + "text size (" + autoSizeMinTextSizeInPx + "px)");
    }

    if (autoSizeStepGranularityInPx <= 0) {
      throw new IllegalArgumentException("The auto-size step granularity ("
                                         + autoSizeStepGranularityInPx + "px) is less or equal to (0px)");
    }

    // All good, persist the configuration.
    mAutoSizeTextType = AUTO_SIZE_TEXT_TYPE_UNIFORM;
    mAutoSizeMinTextSizeInPx = autoSizeMinTextSizeInPx;
    mAutoSizeMaxTextSizeInPx = autoSizeMaxTextSizeInPx;
    mAutoSizeStepGranularityInPx = autoSizeStepGranularityInPx;
    mHasPresetAutoSizeValues = false;
  }

  private void clearAutoSizeConfiguration() {
    mAutoSizeTextType = AUTO_SIZE_TEXT_TYPE_NONE;
    mAutoSizeMinTextSizeInPx = UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE;
    mAutoSizeMaxTextSizeInPx = UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE;
    mAutoSizeStepGranularityInPx = UNSET_AUTO_SIZE_UNIFORM_CONFIGURATION_VALUE;
    mAutoSizeTextSizesInPx = EmptyArray.INT;
    mNeedsAutoSizeText = false;
  }

  // Returns distinct sorted positive values.
  private int[] cleanupAutoSizePresetSizes(int[] presetValues) {
    final int presetValuesLength = presetValues.length;
    if (presetValuesLength == 0) {
      return presetValues;
    }
    Arrays.sort(presetValues);

    final IntArray uniqueValidSizes = new IntArray();
    for (int i = 0; i < presetValuesLength; i++) {
      final int currentPresetValue = presetValues[i];

      if (currentPresetValue > 0
          && uniqueValidSizes.binarySearch(currentPresetValue) < 0) {
        uniqueValidSizes.add(currentPresetValue);
      }
    }

    return presetValuesLength == uniqueValidSizes.size()
           ? presetValues
           : uniqueValidSizes.toArray();
  }

  private boolean setupAutoSizeText() {
    if (supportsAutoSizeText() && mAutoSizeTextType == AUTO_SIZE_TEXT_TYPE_UNIFORM) {
      // Calculate the sizes set based on minimum size, maximum size and step size if we do
      // not have a predefined set of sizes or if the current sizes array is empty.
      if (!mHasPresetAutoSizeValues || mAutoSizeTextSizesInPx.length == 0) {
        final int autoSizeValuesLength = ((int) Math.floor((mAutoSizeMaxTextSizeInPx
                                                            - mAutoSizeMinTextSizeInPx) / mAutoSizeStepGranularityInPx)) + 1;
        final int[] autoSizeTextSizesInPx = new int[autoSizeValuesLength];
        for (int i = 0; i < autoSizeValuesLength; i++) {
          autoSizeTextSizesInPx[i] = Math.round(
            mAutoSizeMinTextSizeInPx + (i * mAutoSizeStepGranularityInPx));
        }
        mAutoSizeTextSizesInPx = cleanupAutoSizePresetSizes(autoSizeTextSizesInPx);
      }

      mNeedsAutoSizeText = true;
    } else {
      mNeedsAutoSizeText = false;
    }

    return mNeedsAutoSizeText;
  }

  private int[] parseDimensionArray(TypedArray dimens) {
    if (dimens == null) {
      return null;
    }
    int[] result = new int[dimens.length()];
    for (int i = 0; i < result.length; i++) {
      result[i] = dimens.getDimensionPixelSize(i, 0);
    }
    return result;
  }

  /**
   * @hide
   */
  @TestApi
  @Override
  public void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    if (requestCode == PROCESS_TEXT_REQUEST_CODE) {
      if (resultCode == Activity.RESULT_OK && data != null) {
        CharSequence result = data.getCharSequenceExtra(Intent.EXTRA_PROCESS_TEXT);
        if (result != null) {
          if (isTextEditable()) {
            ClipData clip = ClipData.newPlainText("", result);
            ContentInfo payload =
              new ContentInfo.Builder(clip, SOURCE_PROCESS_TEXT).build();
            performReceiveContent(payload);
            if (mEditor != null) {
              mEditor.refreshTextActionMode();
            }
          } else {
            if (result.length() > 0) {
              Toast.makeText(getContext(), String.valueOf(result), Toast.LENGTH_LONG)
                .show();
            }
          }
        }
      } else if (mSpannable != null) {
        // Reset the selection.
        Selection.setSelection(mSpannable, getSelectionEnd());
      }
    }
  }

  /**
   * Sets the Typeface taking into account the given attributes.
   *
   * @param typeface a typeface
   * @param familyName family name string, e.g. "serif"
   * @param typefaceIndex an index of the typeface enum, e.g. SANS, SERIF.
   * @param style a typeface style
   * @param weight a weight value for the Typeface or {@code FontStyle.FONT_WEIGHT_UNSPECIFIED}
   *               if not specified.
   */
  private void setTypefaceFromAttrs(@Nullable Typeface typeface, @Nullable String familyName,
                                    @XMLTypefaceAttr int typefaceIndex, @Typeface.Style int style,
                                    @IntRange(from = FontStyle.FONT_WEIGHT_UNSPECIFIED, to = FontStyle.FONT_WEIGHT_MAX)
                                    int weight) {
    if (typeface == null && familyName != null) {
      // Lookup normal Typeface from system font map.
      final Typeface normalTypeface = Typeface.create(familyName, Typeface.NORMAL);
      resolveStyleAndSetTypeface(normalTypeface, style, weight);
    } else if (typeface != null) {
      resolveStyleAndSetTypeface(typeface, style, weight);
    } else {  // both typeface and familyName is null.
      switch (typefaceIndex) {
        case SANS:
          resolveStyleAndSetTypeface(Typeface.SANS_SERIF, style, weight);
          break;
        case SERIF:
          resolveStyleAndSetTypeface(Typeface.SERIF, style, weight);
          break;
        case MONOSPACE:
          resolveStyleAndSetTypeface(Typeface.MONOSPACE, style, weight);
          break;
        case DEFAULT_TYPEFACE:
        default:
          resolveStyleAndSetTypeface(null, style, weight);
          break;
      }
    }
  }

  private void resolveStyleAndSetTypeface(@NonNull Typeface typeface, @Typeface.Style int style,
                                          @IntRange(from = FontStyle.FONT_WEIGHT_UNSPECIFIED, to = FontStyle.FONT_WEIGHT_MAX)
                                          int weight) {
    if (weight >= 0) {
      weight = Math.min(FontStyle.FONT_WEIGHT_MAX, weight);
      final boolean italic = (style & Typeface.ITALIC) != 0;
      setTypeface(Typeface.create(typeface, weight, italic));
    } else {
      setTypeface(typeface, style);
    }
  }

  private void setRelativeDrawablesIfNeeded(Drawable start, Drawable end) {
    boolean hasRelativeDrawables = (start != null) || (end != null);
    if (hasRelativeDrawables) {
      Drawables dr = mDrawables;
      if (dr == null) {
        mDrawables = dr = new Drawables(getContext());
      }
      mDrawables.mOverride = true;
      final Rect compoundRect = dr.mCompoundRect;
      int[] state = getDrawableState();
      if (start != null) {
        start.setBounds(0, 0, start.getIntrinsicWidth(), start.getIntrinsicHeight());
        start.setState(state);
        start.copyBounds(compoundRect);
        start.setCallback(this);

        dr.mDrawableStart = start;
        dr.mDrawableSizeStart = compoundRect.width();
        dr.mDrawableHeightStart = compoundRect.height();
      } else {
        dr.mDrawableSizeStart = dr.mDrawableHeightStart = 0;
      }
      if (end != null) {
        end.setBounds(0, 0, end.getIntrinsicWidth(), end.getIntrinsicHeight());
        end.setState(state);
        end.copyBounds(compoundRect);
        end.setCallback(this);

        dr.mDrawableEnd = end;
        dr.mDrawableSizeEnd = compoundRect.width();
        dr.mDrawableHeightEnd = compoundRect.height();
      } else {
        dr.mDrawableSizeEnd = dr.mDrawableHeightEnd = 0;
      }
      resetResolvedDrawables();
      resolveDrawables();
      applyCompoundDrawableTint();
    }
  }

  @android.view.RemotableViewMethod
  @Override
  public void setEnabled(boolean enabled) {
    if (enabled == isEnabled()) {
      return;
    }

    if (!enabled) {
      // Hide the soft input if the currently active TextView is disabled
      InputMethodManager imm = getInputMethodManager();
      if (imm != null) {
        imm.hideSoftInputFromView(this, 0);
      }
    }

    super.setEnabled(enabled);

    if (enabled) {
      // Make sure IME is updated with current editor info.
      InputMethodManager imm = getInputMethodManager();
      if (imm != null) imm.restartInput(this);
    }

    // Will change text color
    if (mEditor != null) {
      mEditor.invalidateTextDisplayList();
      mEditor.prepareCursorControllers();

      // start or stop the cursor blinking as appropriate
      mEditor.makeBlink();
    }
  }

  /**
   * Sets the typeface and style in which the text should be displayed,
   * and turns on the fake bold and italic bits in the Paint if the
   * Typeface that you provided does not have all the bits in the
   * style that you specified.
   *
   * @attr ref android.R.styleable#TextView_typeface
   * @attr ref android.R.styleable#TextView_textStyle
   */
  public void setTypeface(@Nullable Typeface tf, @Typeface.Style int style) {
    if (style > 0) {
      if (tf == null) {
        tf = Typeface.defaultFromStyle(style);
      } else {
        tf = Typeface.create(tf, style);
      }

      setTypeface(tf);
      // now compute what (if any) algorithmic styling is needed
      int typefaceStyle = tf != null ? tf.getStyle() : 0;
      int need = style & ~typefaceStyle;
      mTextPaint.setFakeBoldText((need & Typeface.BOLD) != 0);
      mTextPaint.setTextSkewX((need & Typeface.ITALIC) != 0 ? -0.25f : 0);
    } else {
      mTextPaint.setFakeBoldText(false);
      mTextPaint.setTextSkewX(0);
      setTypeface(tf);
    }
  }

  /**
   * Subclasses override this to specify that they have a KeyListener
   * by default even if not specifically called for in the XML options.
   */
  protected boolean getDefaultEditable() {
    return false;
  }

  /**
   * Subclasses override this to specify a default movement method.
   */
  protected MovementMethod getDefaultMovementMethod() {
    return null;
  }

  /**
   * Return the text that TextView is displaying. If {@link #setText(CharSequence)} was called
   * with an argument of {@link android.widget.TextView.BufferType#SPANNABLE BufferType.SPANNABLE}
   * or {@link android.widget.TextView.BufferType#EDITABLE BufferType.EDITABLE}, you can cast
   * the return value from this method to Spannable or Editable, respectively.
   *
   * <p>The content of the return value should not be modified. If you want a modifiable one, you
   * should make your own copy first.</p>
   *
   * @return The text displayed by the text view.
   * @attr ref android.R.styleable#TextView_text
   */
  @ViewDebug.CapturedViewProperty
  @InspectableProperty
  public CharSequence getText() {
    if (mUseTextPaddingForUiTranslation) {
      ViewTranslationCallback callback = getViewTranslationCallback();
      if (callback != null && callback instanceof TextViewTranslationCallback) {
        TextViewTranslationCallback defaultCallback =
          (TextViewTranslationCallback) callback;
        if (defaultCallback.isTextPaddingEnabled()
            && defaultCallback.isShowingTranslation()) {
          return defaultCallback.getPaddedText(mText, mTransformed);
        }
      }
    }
    return mText;
  }

  /**
   * Returns the length, in characters, of the text managed by this TextView
   * @return The length of the text managed by the TextView in characters.
   */
  public int length() {
    return mText.length();
  }

  /**
   * Return the text that TextView is displaying as an Editable object. If the text is not
   * editable, null is returned.
   *
   * @see #getText
   */
  public Editable getEditableText() {
    return (mText instanceof Editable) ? (Editable) mText : null;
  }

  /**
   * @hide
   */
  @VisibleForTesting(visibility = VisibleForTesting.Visibility.PACKAGE)
  public CharSequence getTransformed() {
    return mTransformed;
  }

  /**
   * Gets the vertical distance between lines of text, in pixels.
   * Note that markup within the text can cause individual lines
   * to be taller or shorter than this height, and the layout may
   * contain additional first-or last-line padding.
   * @return The height of one standard line in pixels.
   */
  @InspectableProperty
  public int getLineHeight() {
    return FastMath.round(mTextPaint.getFontMetricsInt(null) * mSpacingMult + mSpacingAdd);
  }

  /**
   * Gets the {@link android.text.Layout} that is currently being used to display the text.
   * This value can be null if the text or width has recently changed.
   * @return The Layout that is currently being used to display the text.
   */
  public final Layout getLayout() {
    return mLayout;
  }

  /**
   * @return the {@link android.text.Layout} that is currently being used to
   * display the hint text. This can be null.
   */
  @UnsupportedAppUsage
  final Layout getHintLayout() {
    return mHintLayout;
  }

  /**
   * Retrieve the {@link android.content.UndoManager} that is currently associated
   * with this TextView.  By default there is no associated UndoManager, so null
   * is returned.  One can be associated with the TextView through
   * {@link #setUndoManager(android.content.UndoManager, String)}
   *
   * @hide
   */
  public final UndoManager getUndoManager() {
    // TODO: Consider supporting a global undo manager.
    throw new UnsupportedOperationException("not implemented");
  }


  /**
   * @hide
   */
  @VisibleForTesting
  public final Editor getEditorForTesting() {
    return mEditor;
  }

  /**
   * Associate an {@link android.content.UndoManager} with this TextView.  Once
   * done, all edit operations on the TextView will result in appropriate
   * {@link android.content.UndoOperation} objects pushed on the given UndoManager's
   * stack.
   *
   * @param undoManager The {@link android.content.UndoManager} to associate with
   * this TextView, or null to clear any existing association.
   * @param tag String tag identifying this particular TextView owner in the
   * UndoManager.  This is used to keep the correct association with the
   * {@link android.content.UndoOwner} of any operations inside of the UndoManager.
   *
   * @hide
   */
  public final void setUndoManager(UndoManager undoManager, String tag) {
    // TODO: Consider supporting a global undo manager. An implementation will need to:
    // * createEditorIfNeeded()
    // * Promote to BufferType.EDITABLE if needed.
    // * Update the UndoManager and UndoOwner.
    // Likewise it will need to be able to restore the default UndoManager.
    throw new UnsupportedOperationException("not implemented");
  }

  /**
   * Gets the current {@link KeyListener} for the TextView.
   * This will frequently be null for non-EditText TextViews.
   * @return the current key listener for this TextView.
   *
   * @attr ref android.R.styleable#TextView_numeric
   * @attr ref android.R.styleable#TextView_digits
   * @attr ref android.R.styleable#TextView_phoneNumber
   * @attr ref android.R.styleable#TextView_inputMethod
   * @attr ref android.R.styleable#TextView_capitalize
   * @attr ref android.R.styleable#TextView_autoText
   */
  public final KeyListener getKeyListener() {
    return mEditor == null ? null : mEditor.mKeyListener;
  }

  /**
   * Sets the key listener to be used with this TextView.  This can be null
   * to disallow user input.  Note that this method has significant and
   * subtle interactions with soft keyboards and other input method:
   * see {@link KeyListener#getInputType() KeyListener.getInputType()}
   * for important details.  Calling this method will replace the current
   * content type of the text view with the content type returned by the
   * key listener.
   * <p>
   * Be warned that if you want a TextView with a key listener or movement
   * method not to be focusable, or if you want a TextView without a
   * key listener or movement method to be focusable, you must call
   * {@link #setFocusable} again after calling this to get the focusability
   * back the way you want it.
   *
   * @attr ref android.R.styleable#TextView_numeric
   * @attr ref android.R.styleable#TextView_digits
   * @attr ref android.R.styleable#TextView_phoneNumber
   * @attr ref android.R.styleable#TextView_inputMethod
   * @attr ref android.R.styleable#TextView_capitalize
   * @attr ref android.R.styleable#TextView_autoText
   */
  public void setKeyListener(KeyListener input) {
    mListenerChanged = true;
    setKeyListenerOnly(input);
    fixFocusableAndClickableSettings();

    if (input != null) {
      createEditorIfNeeded();
      setInputTypeFromEditor();
    } else {
      if (mEditor != null) mEditor.mInputType = EditorInfo.TYPE_NULL;
    }

    InputMethodManager imm = getInputMethodManager();
    if (imm != null) imm.restartInput(this);
  }

  private void setInputTypeFromEditor() {
    try {
      mEditor.mInputType = mEditor.mKeyListener.getInputType();
    } catch (IncompatibleClassChangeError e) {
      mEditor.mInputType = EditorInfo.TYPE_CLASS_TEXT;
    }
    // Change inputType, without affecting transformation.
    // No need to applySingleLine since mSingleLine is unchanged.
    setInputTypeSingleLine(mSingleLine);
  }

  private void setKeyListenerOnly(KeyListener input) {
    if (mEditor == null && input == null) return; // null is the default value

    createEditorIfNeeded();
    if (mEditor.mKeyListener != input) {
      mEditor.mKeyListener = input;
      if (input != null && !(mText instanceof Editable)) {
        setText(mText);
      }

      setFilters((Editable) mText, mFilters);
    }
  }

  /**
   * Gets the {@link android.text.method.MovementMethod} being used for this TextView,
   * which provides positioning, scrolling, and text selection functionality.
   * This will frequently be null for non-EditText TextViews.
   * @return the movement method being used for this TextView.
   * @see android.text.method.MovementMethod
   */
  public final MovementMethod getMovementMethod() {
    return mMovement;
  }

  /**
   * Sets the {@link android.text.method.MovementMethod} for handling arrow key movement
   * for this TextView. This can be null to disallow using the arrow keys to move the
   * cursor or scroll the view.
   * <p>
   * Be warned that if you want a TextView with a key listener or movement
   * method not to be focusable, or if you want a TextView without a
   * key listener or movement method to be focusable, you must call
   * {@link #setFocusable} again after calling this to get the focusability
   * back the way you want it.
   */
  public final void setMovementMethod(MovementMethod movement) {
    if (mMovement != movement) {
      mMovement = movement;

      if (movement != null && mSpannable == null) {
        setText(mText);
      }

      fixFocusableAndClickableSettings();

      // SelectionModifierCursorController depends on textCanBeSelected, which depends on
      // mMovement
      if (mEditor != null) mEditor.prepareCursorControllers();
    }
  }

  private void fixFocusableAndClickableSettings() {
    if (mMovement != null || (mEditor != null && mEditor.mKeyListener != null)) {
      setFocusable(FOCUSABLE);
      setClickable(true);
      setLongClickable(true);
    } else {
      setFocusable(FOCUSABLE_AUTO);
      setClickable(false);
      setLongClickable(false);
    }
  }

  /**
   * Gets the current {@link android.text.method.TransformationMethod} for the TextView.
   * This is frequently null, except for single-line and password fields.
   * @return the current transformation method for this TextView.
   *
   * @attr ref android.R.styleable#TextView_password
   * @attr ref android.R.styleable#TextView_singleLine
   */
  public final TransformationMethod getTransformationMethod() {
    return mTransformation;
  }

  /**
   * Sets the transformation that is applied to the text that this
   * TextView is displaying.
   *
   * @attr ref android.R.styleable#TextView_password
   * @attr ref android.R.styleable#TextView_singleLine
   */
  public final void setTransformationMethod(TransformationMethod method) {
    if (mEditor != null) {
      mEditor.setTransformationMethod(method);
    } else {
      setTransformationMethodInternal(method, /* updateText */ true);
    }
  }

  /**
   * Set the transformation that is applied to the text that this TextView is displaying,
   * optionally call the setText.
   * @param method the new transformation method to be set.
   * @param updateText whether the call {@link #setText} which will update the TextView to display
   *                   the new content. This method is helpful when updating
   *                   {@link TransformationMethod} inside {@link #setText}. It should only be
   *                   false if text will be updated immediately after this call, otherwise the
   *                   TextView will enter an inconsistent state.
   */
  void setTransformationMethodInternal(@Nullable TransformationMethod method,
                                       boolean updateText) {
    if (method == mTransformation) {
      // Avoid the setText() below if the transformation is
      // the same.
      return;
    }
    if (mTransformation != null) {
      if (mSpannable != null) {
        mSpannable.removeSpan(mTransformation);
      }
    }

    mTransformation = method;

    if (method instanceof TransformationMethod2) {
      TransformationMethod2 method2 = (TransformationMethod2) method;
      mAllowTransformationLengthChange = !isTextSelectable() && !(mText instanceof Editable);
      method2.setLengthChangesAllowed(mAllowTransformationLengthChange);
    } else {
      mAllowTransformationLengthChange = false;
    }

    if (updateText) {
      if (Flags.insertModeNotUpdateSelection()) {
        // Update the transformation text.
        if (mTransformation == null) {
          mTransformed = mText;
        } else {
          mTransformed = mTransformation.getTransformation(mText, this);
        }
        if (mTransformed == null) {
          // Should not happen if the transformation method follows the non-null
          // postcondition.
          mTransformed = "";
        }
        final boolean isOffsetMapping = mTransformed instanceof OffsetMapping;

        // If the mText is a Spannable and the new TransformationMethod needs to listen to
        // its updates, apply the watcher on it.
        if (mTransformation != null && mText instanceof Spannable
            && (!mAllowTransformationLengthChange || isOffsetMapping)) {
          Spannable sp = (Spannable) mText;
          final int priority = isOffsetMapping ? OFFSET_MAPPING_SPAN_PRIORITY : 0;
          sp.setSpan(mTransformation, 0, mText.length(),
                     Spanned.SPAN_INCLUSIVE_INCLUSIVE
                     | (priority << Spanned.SPAN_PRIORITY_SHIFT));
        }
        if (mLayout != null) {
          nullLayouts();
          requestLayout();
          invalidate();
        }
      } else {
        setText(mText);
      }
    }

    if (hasPasswordTransformationMethod()) {
      notifyViewAccessibilityStateChangedIfNeeded(
        AccessibilityEvent.CONTENT_CHANGE_TYPE_UNDEFINED);
    }

    // PasswordTransformationMethod always have LTR text direction heuristics returned by
    // getTextDirectionHeuristic, needs reset
    mTextDir = getTextDirectionHeuristic();
  }

  /**
   * Returns the top padding of the view, plus space for the top
   * Drawable if any.
   */
  public int getCompoundPaddingTop() {
    final Drawables dr = mDrawables;
    if (dr == null || dr.mShowing[Drawables.TOP] == null) {
      return mPaddingTop;
    } else {
      return mPaddingTop + dr.mDrawablePadding + dr.mDrawableSizeTop;
    }
  }

  /**
   * Returns the bottom padding of the view, plus space for the bottom
   * Drawable if any.
   */
  public int getCompoundPaddingBottom() {
    final Drawables dr = mDrawables;
    if (dr == null || dr.mShowing[Drawables.BOTTOM] == null) {
      return mPaddingBottom;
    } else {
      return mPaddingBottom + dr.mDrawablePadding + dr.mDrawableSizeBottom;
    }
  }

  /**
   * Returns the left padding of the view, plus space for the left
   * Drawable if any.
   */
  public int getCompoundPaddingLeft() {
    final Drawables dr = mDrawables;
    if (dr == null || dr.mShowing[Drawables.LEFT] == null) {
      return mPaddingLeft;
    } else {
      return mPaddingLeft + dr.mDrawablePadding + dr.mDrawableSizeLeft;
    }
  }

  /**
   * Returns the right padding of the view, plus space for the right
   * Drawable if any.
   */
  public int getCompoundPaddingRight() {
    final Drawables dr = mDrawables;
    if (dr == null || dr.mShowing[Drawables.RIGHT] == null) {
      return mPaddingRight;
    } else {
      return mPaddingRight + dr.mDrawablePadding + dr.mDrawableSizeRight;
    }
  }

  /**
   * Returns the start padding of the view, plus space for the start
   * Drawable if any.
   */
  public int getCompoundPaddingStart() {
    resolveDrawables();
    switch(getLayoutDirection()) {
      default:
      case LAYOUT_DIRECTION_LTR:
        return getCompoundPaddingLeft();
      case LAYOUT_DIRECTION_RTL:
        return getCompoundPaddingRight();
    }
  }

  /**
   * Returns the end padding of the view, plus space for the end
   * Drawable if any.
   */
  public int getCompoundPaddingEnd() {
    resolveDrawables();
    switch(getLayoutDirection()) {
      default:
      case LAYOUT_DIRECTION_LTR:
        return getCompoundPaddingRight();
      case LAYOUT_DIRECTION_RTL:
        return getCompoundPaddingLeft();
    }
  }

  /**
   * Returns the extended top padding of the view, including both the
   * top Drawable if any and any extra space to keep more than maxLines
   * of text from showing.  It is only valid to call this after measuring.
   */
  public int getExtendedPaddingTop() {
    if (mMaxMode != LINES) {
      return getCompoundPaddingTop();
    }

    if (mLayout == null) {
      assumeLayout();
    }

    if (mLayout.getLineCount() <= mMaximum) {
      return getCompoundPaddingTop();
    }

    int top = getCompoundPaddingTop();
    int bottom = getCompoundPaddingBottom();
    int viewht = getHeight() - top - bottom;
    int layoutht = mLayout.getLineTop(mMaximum);

    if (layoutht >= viewht) {
      return top;
    }

    final int gravity = mGravity & Gravity.VERTICAL_GRAVITY_MASK;
    if (gravity == Gravity.TOP) {
      return top;
    } else if (gravity == Gravity.BOTTOM) {
      return top + viewht - layoutht;
    } else { // (gravity == Gravity.CENTER_VERTICAL)
      return top + (viewht - layoutht) / 2;
    }
  }

  /**
   * Returns the extended bottom padding of the view, including both the
   * bottom Drawable if any and any extra space to keep more than maxLines
   * of text from showing.  It is only valid to call this after measuring.
   */
  public int getExtendedPaddingBottom() {
    if (mMaxMode != LINES) {
      return getCompoundPaddingBottom();
    }

    if (mLayout == null) {
      assumeLayout();
    }

    if (mLayout.getLineCount() <= mMaximum) {
      return getCompoundPaddingBottom();
    }

    int top = getCompoundPaddingTop();
    int bottom = getCompoundPaddingBottom();
    int viewht = getHeight() - top - bottom;
    int layoutht = mLayout.getLineTop(mMaximum);

    if (layoutht >= viewht) {
      return bottom;
    }

    final int gravity = mGravity & Gravity.VERTICAL_GRAVITY_MASK;
    if (gravity == Gravity.TOP) {
      return bottom + viewht - layoutht;
    } else if (gravity == Gravity.BOTTOM) {
      return bottom;
    } else { // (gravity == Gravity.CENTER_VERTICAL)
      return bottom + (viewht - layoutht) / 2;
    }
  }

  /**
   * Returns the total left padding of the view, including the left
   * Drawable if any.
   */
  public int getTotalPaddingLeft() {
    return getCompoundPaddingLeft();
  }

  /**
   * Returns the total right padding of the view, including the right
   * Drawable if any.
   */
  public int getTotalPaddingRight() {
    return getCompoundPaddingRight();
  }

  /**
   * Returns the total start padding of the view, including the start
   * Drawable if any.
   */
  public int getTotalPaddingStart() {
    return getCompoundPaddingStart();
  }

  /**
   * Returns the total end padding of the view, including the end
   * Drawable if any.
   */
  public int getTotalPaddingEnd() {
    return getCompoundPaddingEnd();
  }

  /**
   * Returns the total top padding of the view, including the top
   * Drawable if any, the extra space to keep more than maxLines
   * from showing, and the vertical offset for gravity, if any.
   */
  public int getTotalPaddingTop() {
    return getExtendedPaddingTop() + getVerticalOffset(true);
  }

  /**
   * Returns the total bottom padding of the view, including the bottom
   * Drawable if any, the extra space to keep more than maxLines
   * from showing, and the vertical offset for gravity, if any.
   */
  public int getTotalPaddingBottom() {
    return getExtendedPaddingBottom() + getBottomVerticalOffset(true);
  }

  /**
   * Sets the Drawables (if any) to appear to the left of, above, to the
   * right of, and below the text. Use {@code null} if you do not want a
   * Drawable there. The Drawables must already have had
   * {@link Drawable#setBounds} called.
   * <p>
   * Calling this method will overwrite any Drawables previously set using
   * {@link #setCompoundDrawablesRelative} or related methods.
   *
   * @attr ref android.R.styleable#TextView_drawableLeft
   * @attr ref android.R.styleable#TextView_drawableTop
   * @attr ref android.R.styleable#TextView_drawableRight
   * @attr ref android.R.styleable#TextView_drawableBottom
   */
  public void setCompoundDrawables(@Nullable Drawable left, @Nullable Drawable top,
                                   @Nullable Drawable right, @Nullable Drawable bottom) {
    Drawables dr = mDrawables;

    // We're switching to absolute, discard relative.
    if (dr != null) {
      if (dr.mDrawableStart != null) dr.mDrawableStart.setCallback(null);
      dr.mDrawableStart = null;
      if (dr.mDrawableEnd != null) dr.mDrawableEnd.setCallback(null);
      dr.mDrawableEnd = null;
      dr.mDrawableSizeStart = dr.mDrawableHeightStart = 0;
      dr.mDrawableSizeEnd = dr.mDrawableHeightEnd = 0;
    }

    final boolean drawables = left != null || top != null || right != null || bottom != null;
    if (!drawables) {
      // Clearing drawables...  can we free the data structure?
      if (dr != null) {
        if (!dr.hasMetadata()) {
          mDrawables = null;
        } else {
          // We need to retain the last set padding, so just clear
          // out all of the fields in the existing structure.
          for (int i = dr.mShowing.length - 1; i >= 0; i--) {
            if (dr.mShowing[i] != null) {
              dr.mShowing[i].setCallback(null);
            }
            dr.mShowing[i] = null;
          }
          dr.mDrawableSizeLeft = dr.mDrawableHeightLeft = 0;
          dr.mDrawableSizeRight = dr.mDrawableHeightRight = 0;
          dr.mDrawableSizeTop = dr.mDrawableWidthTop = 0;
          dr.mDrawableSizeBottom = dr.mDrawableWidthBottom = 0;
        }
      }
    } else {
      if (dr == null) {
        mDrawables = dr = new Drawables(getContext());
      }

      mDrawables.mOverride = false;

      if (dr.mShowing[Drawables.LEFT] != left && dr.mShowing[Drawables.LEFT] != null) {
        dr.mShowing[Drawables.LEFT].setCallback(null);
      }
      dr.mShowing[Drawables.LEFT] = left;

      if (dr.mShowing[Drawables.TOP] != top && dr.mShowing[Drawables.TOP] != null) {
        dr.mShowing[Drawables.TOP].setCallback(null);
      }
      dr.mShowing[Drawables.TOP] = top;

      if (dr.mShowing[Drawables.RIGHT] != right && dr.mShowing[Drawables.RIGHT] != null) {
        dr.mShowing[Drawables.RIGHT].setCallback(null);
      }
      dr.mShowing[Drawables.RIGHT] = right;

      if (dr.mShowing[Drawables.BOTTOM] != bottom && dr.mShowing[Drawables.BOTTOM] != null) {
        dr.mShowing[Drawables.BOTTOM].setCallback(null);
      }
      dr.mShowing[Drawables.BOTTOM] = bottom;

      final Rect compoundRect = dr.mCompoundRect;
      int[] state;

      state = getDrawableState();

      if (left != null) {
        left.setState(state);
        left.copyBounds(compoundRect);
        left.setCallback(this);
        dr.mDrawableSizeLeft = compoundRect.width();
        dr.mDrawableHeightLeft = compoundRect.height();
      } else {
        dr.mDrawableSizeLeft = dr.mDrawableHeightLeft = 0;
      }

      if (right != null) {
        right.setState(state);
        right.copyBounds(compoundRect);
        right.setCallback(this);
        dr.mDrawableSizeRight = compoundRect.width();
        dr.mDrawableHeightRight = compoundRect.height();
      } else {
        dr.mDrawableSizeRight = dr.mDrawableHeightRight = 0;
      }

      if (top != null) {
        top.setState(state);
        top.copyBounds(compoundRect);
        top.setCallback(this);
        dr.mDrawableSizeTop = compoundRect.height();
        dr.mDrawableWidthTop = compoundRect.width();
      } else {
        dr.mDrawableSizeTop = dr.mDrawableWidthTop = 0;
      }

      if (bottom != null) {
        bottom.setState(state);
        bottom.copyBounds(compoundRect);
        bottom.setCallback(this);
        dr.mDrawableSizeBottom = compoundRect.height();
        dr.mDrawableWidthBottom = compoundRect.width();
      } else {
        dr.mDrawableSizeBottom = dr.mDrawableWidthBottom = 0;
      }
    }

    // Save initial left/right drawables
    if (dr != null) {
      dr.mDrawableLeftInitial = left;
      dr.mDrawableRightInitial = right;
    }

    resetResolvedDrawables();
    resolveDrawables();
    applyCompoundDrawableTint();
    invalidate();
    requestLayout();
  }

  /**
   * Sets the Drawables (if any) to appear to the left of, above, to the
   * right of, and below the text. Use 0 if you do not want a Drawable there.
   * The Drawables' bounds will be set to their intrinsic bounds.
   * <p>
   * Calling this method will overwrite any Drawables previously set using
   * {@link #setCompoundDrawablesRelative} or related methods.
   *
   * @param left Resource identifier of the left Drawable.
   * @param top Resource identifier of the top Drawable.
   * @param right Resource identifier of the right Drawable.
   * @param bottom Resource identifier of the bottom Drawable.
   *
   * @attr ref android.R.styleable#TextView_drawableLeft
   * @attr ref android.R.styleable#TextView_drawableTop
   * @attr ref android.R.styleable#TextView_drawableRight
   * @attr ref android.R.styleable#TextView_drawableBottom
   */
  @android.view.RemotableViewMethod
  public void setCompoundDrawablesWithIntrinsicBounds(@DrawableRes int left,
                                                      @DrawableRes int top, @DrawableRes int right, @DrawableRes int bottom) {
    final Context context = getContext();
    setCompoundDrawablesWithIntrinsicBounds(left != 0 ? context.getDrawable(left) : null,
                                            top != 0 ? context.getDrawable(top) : null,
                                            right != 0 ? context.getDrawable(right) : null,
                                            bottom != 0 ? context.getDrawable(bottom) : null);
  }

  /**
   * Sets the Drawables (if any) to appear to the left of, above, to the
   * right of, and below the text. Use {@code null} if you do not want a
   * Drawable there. The Drawables' bounds will be set to their intrinsic
   * bounds.
   * <p>
   * Calling this method will overwrite any Drawables previously set using
   * {@link #setCompoundDrawablesRelative} or related methods.
   *
   * @attr ref android.R.styleable#TextView_drawableLeft
   * @attr ref android.R.styleable#TextView_drawableTop
   * @attr ref android.R.styleable#TextView_drawableRight
   * @attr ref android.R.styleable#TextView_drawableBottom
   */
  @android.view.RemotableViewMethod
  public void setCompoundDrawablesWithIntrinsicBounds(@Nullable Drawable left,
                                                      @Nullable Drawable top, @Nullable Drawable right, @Nullable Drawable bottom) {

    if (left != null) {
      left.setBounds(0, 0, left.getIntrinsicWidth(), left.getIntrinsicHeight());
    }
    if (right != null) {
      right.setBounds(0, 0, right.getIntrinsicWidth(), right.getIntrinsicHeight());
    }
    if (top != null) {
      top.setBounds(0, 0, top.getIntrinsicWidth(), top.getIntrinsicHeight());
    }
    if (bottom != null) {
      bottom.setBounds(0, 0, bottom.getIntrinsicWidth(), bottom.getIntrinsicHeight());
    }
    setCompoundDrawables(left, top, right, bottom);
  }

  /**
   * Sets the Drawables (if any) to appear to the start of, above, to the end
   * of, and below the text. Use {@code null} if you do not want a Drawable
   * there. The Drawables must already have had {@link Drawable#setBounds}
   * called.
   * <p>
   * Calling this method will overwrite any Drawables previously set using
   * {@link #setCompoundDrawables} or related methods.
   *
   * @attr ref android.R.styleable#TextView_drawableStart
   * @attr ref android.R.styleable#TextView_drawableTop
   * @attr ref android.R.styleable#TextView_drawableEnd
   * @attr ref android.R.styleable#TextView_drawableBottom
   */
  @android.view.RemotableViewMethod
  public void setCompoundDrawablesRelative(@Nullable Drawable start, @Nullable Drawable top,
                                           @Nullable Drawable end, @Nullable Drawable bottom) {
    Drawables dr = mDrawables;

    // We're switching to relative, discard absolute.
    if (dr != null) {
      if (dr.mShowing[Drawables.LEFT] != null) {
        dr.mShowing[Drawables.LEFT].setCallback(null);
      }
      dr.mShowing[Drawables.LEFT] = dr.mDrawableLeftInitial = null;
      if (dr.mShowing[Drawables.RIGHT] != null) {
        dr.mShowing[Drawables.RIGHT].setCallback(null);
      }
      dr.mShowing[Drawables.RIGHT] = dr.mDrawableRightInitial = null;
      dr.mDrawableSizeLeft = dr.mDrawableHeightLeft = 0;
      dr.mDrawableSizeRight = dr.mDrawableHeightRight = 0;
    }

    final boolean drawables = start != null || top != null
                              || end != null || bottom != null;

    if (!drawables) {
      // Clearing drawables...  can we free the data structure?
      if (dr != null) {
        if (!dr.hasMetadata()) {
          mDrawables = null;
        } else {
          // We need to retain the last set padding, so just clear
          // out all of the fields in the existing structure.
          if (dr.mDrawableStart != null) dr.mDrawableStart.setCallback(null);
          dr.mDrawableStart = null;
          if (dr.mShowing[Drawables.TOP] != null) {
            dr.mShowing[Drawables.TOP].setCallback(null);
          }
          dr.mShowing[Drawables.TOP] = null;
          if (dr.mDrawableEnd != null) {
            dr.mDrawableEnd.setCallback(null);
          }
          dr.mDrawableEnd = null;
          if (dr.mShowing[Drawables.BOTTOM] != null) {
            dr.mShowing[Drawables.BOTTOM].setCallback(null);
          }
          dr.mShowing[Drawables.BOTTOM] = null;
          dr.mDrawableSizeStart = dr.mDrawableHeightStart = 0;
          dr.mDrawableSizeEnd = dr.mDrawableHeightEnd = 0;
          dr.mDrawableSizeTop = dr.mDrawableWidthTop = 0;
          dr.mDrawableSizeBottom = dr.mDrawableWidthBottom = 0;
        }
      }
    } else {
      if (dr == null) {
        mDrawables = dr = new Drawables(getContext());
      }

      mDrawables.mOverride = true;

      if (dr.mDrawableStart != start && dr.mDrawableStart != null) {
        dr.mDrawableStart.setCallback(null);
      }
      dr.mDrawableStart = start;

      if (dr.mShowing[Drawables.TOP] != top && dr.mShowing[Drawables.TOP] != null) {
        dr.mShowing[Drawables.TOP].setCallback(null);
      }
      dr.mShowing[Drawables.TOP] = top;

      if (dr.mDrawableEnd != end && dr.mDrawableEnd != null) {
        dr.mDrawableEnd.setCallback(null);
      }
      dr.mDrawableEnd = end;

      if (dr.mShowing[Drawables.BOTTOM] != bottom && dr.mShowing[Drawables.BOTTOM] != null) {
        dr.mShowing[Drawables.BOTTOM].setCallback(null);
      }
      dr.mShowing[Drawables.BOTTOM] = bottom;

      final Rect compoundRect = dr.mCompoundRect;
      int[] state;

      state = getDrawableState();

      if (start != null) {
        start.setState(state);
        start.copyBounds(compoundRect);
        start.setCallback(this);
        dr.mDrawableSizeStart = compoundRect.width();
        dr.mDrawableHeightStart = compoundRect.height();
      } else {
        dr.mDrawableSizeStart = dr.mDrawableHeightStart = 0;
      }

      if (end != null) {
        end.setState(state);
        end.copyBounds(compoundRect);
        end.setCallback(this);
        dr.mDrawableSizeEnd = compoundRect.width();
        dr.mDrawableHeightEnd = compoundRect.height();
      } else {
        dr.mDrawableSizeEnd = dr.mDrawableHeightEnd = 0;
      }

      if (top != null) {
        top.setState(state);
        top.copyBounds(compoundRect);
        top.setCallback(this);
        dr.mDrawableSizeTop = compoundRect.height();
        dr.mDrawableWidthTop = compoundRect.width();
      } else {
        dr.mDrawableSizeTop = dr.mDrawableWidthTop = 0;
      }

      if (bottom != null) {
        bottom.setState(state);
        bottom.copyBounds(compoundRect);
        bottom.setCallback(this);
        dr.mDrawableSizeBottom = compoundRect.height();
        dr.mDrawableWidthBottom = compoundRect.width();
      } else {
        dr.mDrawableSizeBottom = dr.mDrawableWidthBottom = 0;
      }
    }

    resetResolvedDrawables();
    resolveDrawables();
    invalidate();
    requestLayout();
  }

  /**
   * Sets the Drawables (if any) to appear to the start of, above, to the end
   * of, and below the text. Use 0 if you do not want a Drawable there. The
   * Drawables' bounds will be set to their intrinsic bounds.
   * <p>
   * Calling this method will overwrite any Drawables previously set using
   * {@link #setCompoundDrawables} or related methods.
   *
   * @param start Resource identifier of the start Drawable.
   * @param top Resource identifier of the top Drawable.
   * @param end Resource identifier of the end Drawable.
   * @param bottom Resource identifier of the bottom Drawable.
   *
   * @attr ref android.R.styleable#TextView_drawableStart
   * @attr ref android.R.styleable#TextView_drawableTop
   * @attr ref android.R.styleable#TextView_drawableEnd
   * @attr ref android.R.styleable#TextView_drawableBottom
   */
  @android.view.RemotableViewMethod
  public void setCompoundDrawablesRelativeWithIntrinsicBounds(@DrawableRes int start,
                                                              @DrawableRes int top, @DrawableRes int end, @DrawableRes int bottom) {
    final Context context = getContext();
    setCompoundDrawablesRelativeWithIntrinsicBounds(
      start != 0 ? context.getDrawable(start) : null,
      top != 0 ? context.getDrawable(top) : null,
      end != 0 ? context.getDrawable(end) : null,
      bottom != 0 ? context.getDrawable(bottom) : null);
  }

  /**
   * Sets the Drawables (if any) to appear to the start of, above, to the end
   * of, and below the text. Use {@code null} if you do not want a Drawable
   * there. The Drawables' bounds will be set to their intrinsic bounds.
   * <p>
   * Calling this method will overwrite any Drawables previously set using
   * {@link #setCompoundDrawables} or related methods.
   *
   * @attr ref android.R.styleable#TextView_drawableStart
   * @attr ref android.R.styleable#TextView_drawableTop
   * @attr ref android.R.styleable#TextView_drawableEnd
   * @attr ref android.R.styleable#TextView_drawableBottom
   */
  @android.view.RemotableViewMethod
  public void setCompoundDrawablesRelativeWithIntrinsicBounds(@Nullable Drawable start,
                                                              @Nullable Drawable top, @Nullable Drawable end, @Nullable Drawable bottom) {

    if (start != null) {
      start.setBounds(0, 0, start.getIntrinsicWidth(), start.getIntrinsicHeight());
    }
    if (end != null) {
      end.setBounds(0, 0, end.getIntrinsicWidth(), end.getIntrinsicHeight());
    }
    if (top != null) {
      top.setBounds(0, 0, top.getIntrinsicWidth(), top.getIntrinsicHeight());
    }
    if (bottom != null) {
      bottom.setBounds(0, 0, bottom.getIntrinsicWidth(), bottom.getIntrinsicHeight());
    }
    setCompoundDrawablesRelative(start, top, end, bottom);
  }

  /**
   * Returns drawables for the left, top, right, and bottom borders.
   *
   * @attr ref android.R.styleable#TextView_drawableLeft
   * @attr ref android.R.styleable#TextView_drawableTop
   * @attr ref android.R.styleable#TextView_drawableRight
   * @attr ref android.R.styleable#TextView_drawableBottom
   */
  @NonNull
  public Drawable[] getCompoundDrawables() {
    final Drawables dr = mDrawables;
    if (dr != null) {
      return dr.mShowing.clone();
    } else {
      return new Drawable[] { null, null, null, null };
    }
  }

  /**
   * Returns drawables for the start, top, end, and bottom borders.
   *
   * @attr ref android.R.styleable#TextView_drawableStart
   * @attr ref android.R.styleable#TextView_drawableTop
   * @attr ref android.R.styleable#TextView_drawableEnd
   * @attr ref android.R.styleable#TextView_drawableBottom
   */
  @NonNull
  public Drawable[] getCompoundDrawablesRelative() {
    final Drawables dr = mDrawables;
    if (dr != null) {
      return new Drawable[] {
        dr.mDrawableStart, dr.mShowing[Drawables.TOP],
        dr.mDrawableEnd, dr.mShowing[Drawables.BOTTOM]
      };
    } else {
      return new Drawable[] { null, null, null, null };
    }
  }

  /**
   * Sets the size of the padding between the compound drawables and
   * the text.
   *
   * @attr ref android.R.styleable#TextView_drawablePadding
   */
  @android.view.RemotableViewMethod
  public void setCompoundDrawablePadding(int pad) {
    Drawables dr = mDrawables;
    if (pad == 0) {
      if (dr != null) {
        dr.mDrawablePadding = pad;
      }
    } else {
      if (dr == null) {
        mDrawables = dr = new Drawables(getContext());
      }
      dr.mDrawablePadding = pad;
    }

    invalidate();
    requestLayout();
  }

  /**
   * Returns the padding between the compound drawables and the text.
   *
   * @attr ref android.R.styleable#TextView_drawablePadding
   */
  @InspectableProperty(name = "drawablePadding")
  public int getCompoundDrawablePadding() {
    final Drawables dr = mDrawables;
    return dr != null ? dr.mDrawablePadding : 0;
  }

  /**
   * Applies a tint to the compound drawables. Does not modify the
   * current tint mode, which is {@link BlendMode#SRC_IN} by default.
   * <p>
   * Subsequent calls to
   * {@link #setCompoundDrawables(Drawable, Drawable, Drawable, Drawable)}
   * and related methods will automatically mutate the drawables and apply
   * the specified tint and tint mode using
   * {@link Drawable#setTintList(ColorStateList)}.
   *
   * @param tint the tint to apply, may be {@code null} to clear tint
   *
   * @attr ref android.R.styleable#TextView_drawableTint
   * @see #getCompoundDrawableTintList()
   * @see Drawable#setTintList(ColorStateList)
   */
  public void setCompoundDrawableTintList(@Nullable ColorStateList tint) {
    if (mDrawables == null) {
      mDrawables = new Drawables(getContext());
    }
    mDrawables.mTintList = tint;
    mDrawables.mHasTint = true;

    applyCompoundDrawableTint();
  }

  /**
   * @return the tint applied to the compound drawables
   * @attr ref android.R.styleable#TextView_drawableTint
   * @see #setCompoundDrawableTintList(ColorStateList)
   */
  @InspectableProperty(name = "drawableTint")
  public ColorStateList getCompoundDrawableTintList() {
    return mDrawables != null ? mDrawables.mTintList : null;
  }

  /**
   * Specifies the blending mode used to apply the tint specified by
   * {@link #setCompoundDrawableTintList(ColorStateList)} to the compound
   * drawables. The default mode is {@link PorterDuff.Mode#SRC_IN}.
   *
   * @param tintMode the blending mode used to apply the tint, may be
   *                 {@code null} to clear tint
   * @attr ref android.R.styleable#TextView_drawableTintMode
   * @see #setCompoundDrawableTintList(ColorStateList)
   * @see Drawable#setTintMode(PorterDuff.Mode)
   */
  public void setCompoundDrawableTintMode(@Nullable PorterDuff.Mode tintMode) {
    setCompoundDrawableTintBlendMode(tintMode != null
                                     ? BlendMode.fromValue(tintMode.nativeInt) : null);
  }

  /**
   * Specifies the blending mode used to apply the tint specified by
   * {@link #setCompoundDrawableTintList(ColorStateList)} to the compound
   * drawables. The default mode is {@link PorterDuff.Mode#SRC_IN}.
   *
   * @param blendMode the blending mode used to apply the tint, may be
   *                 {@code null} to clear tint
   * @attr ref android.R.styleable#TextView_drawableTintMode
   * @see #setCompoundDrawableTintList(ColorStateList)
   * @see Drawable#setTintBlendMode(BlendMode)
   */
  public void setCompoundDrawableTintBlendMode(@Nullable BlendMode blendMode) {
    if (mDrawables == null) {
      mDrawables = new Drawables(getContext());
    }
    mDrawables.mBlendMode = blendMode;
    mDrawables.mHasTintMode = true;

    applyCompoundDrawableTint();
  }

  /**
   * Returns the blending mode used to apply the tint to the compound
   * drawables, if specified.
   *
   * @return the blending mode used to apply the tint to the compound
   *         drawables
   * @attr ref android.R.styleable#TextView_drawableTintMode
   * @see #setCompoundDrawableTintMode(PorterDuff.Mode)
   *
   */
  @InspectableProperty(name = "drawableTintMode")
  public PorterDuff.Mode getCompoundDrawableTintMode() {
    BlendMode mode = getCompoundDrawableTintBlendMode();
    return mode != null ? BlendMode.blendModeToPorterDuffMode(mode) : null;
  }

  /**
   * Returns the blending mode used to apply the tint to the compound
   * drawables, if specified.
   *
   * @return the blending mode used to apply the tint to the compound
   *         drawables
   * @attr ref android.R.styleable#TextView_drawableTintMode
   * @see #setCompoundDrawableTintBlendMode(BlendMode)
   */
  @InspectableProperty(name = "drawableBlendMode",
    attributeId = com.android.internal.R.styleable.TextView_drawableTintMode)
  public @Nullable BlendMode getCompoundDrawableTintBlendMode() {
    return mDrawables != null ? mDrawables.mBlendMode : null;
  }

  private void applyCompoundDrawableTint() {
    if (mDrawables == null) {
      return;
    }

    if (mDrawables.mHasTint || mDrawables.mHasTintMode) {
      final ColorStateList tintList = mDrawables.mTintList;
      final BlendMode blendMode = mDrawables.mBlendMode;
      final boolean hasTint = mDrawables.mHasTint;
      final boolean hasTintMode = mDrawables.mHasTintMode;
      final int[] state = getDrawableState();

      for (Drawable dr : mDrawables.mShowing) {
        if (dr == null) {
          continue;
        }

        if (dr == mDrawables.mDrawableError) {
          // From a developer's perspective, the error drawable isn't
          // a compound drawable. Don't apply the generic compound
          // drawable tint to it.
          continue;
        }

        dr.mutate();

        if (hasTint) {
          dr.setTintList(tintList);
        }

        if (hasTintMode) {
          dr.setTintBlendMode(blendMode);
        }

        // The drawable (or one of its children) may not have been
        // stateful before applying the tint, so let's try again.
        if (dr.isStateful()) {
          dr.setState(state);
        }
      }
    }
  }

  /**
   * @inheritDoc
   *
   * @see #setFirstBaselineToTopHeight(int)
   * @see #setLastBaselineToBottomHeight(int)
   */
  @Override
  public void setPadding(int left, int top, int right, int bottom) {
    if (left != mPaddingLeft
        || right != mPaddingRight
        || top != mPaddingTop
        ||  bottom != mPaddingBottom) {
      nullLayouts();
    }

    // the super call will requestLayout()
    super.setPadding(left, top, right, bottom);
    invalidate();
  }

  /**
   * @inheritDoc
   *
   * @see #setFirstBaselineToTopHeight(int)
   * @see #setLastBaselineToBottomHeight(int)
   */
  @Override
  public void setPaddingRelative(int start, int top, int end, int bottom) {
    if (start != getPaddingStart()
        || end != getPaddingEnd()
        || top != mPaddingTop
        || bottom != mPaddingBottom) {
      nullLayouts();
    }

    // the super call will requestLayout()
    super.setPaddingRelative(start, top, end, bottom);
    invalidate();
  }

  /**
   * Updates the top padding of the TextView so that {@code firstBaselineToTopHeight} is
   * the distance between the top of the TextView and first line's baseline.
   * <p>
   * <img src="{@docRoot}reference/android/images/text/widget/first_last_baseline.png" />
   * <figcaption>First and last baseline metrics for a TextView.</figcaption>
   *
   * <strong>Note</strong> that if {@code FontMetrics.top} or {@code FontMetrics.ascent} was
   * already greater than {@code firstBaselineToTopHeight}, the top padding is not updated.
   * Moreover since this function sets the top padding, if the height of the TextView is less than
   * the sum of top padding, line height and bottom padding, top of the line will be pushed
   * down and bottom will be clipped.
   *
   * @param firstBaselineToTopHeight distance between first baseline to top of the container
   *      in pixels
   *
   * @see #getFirstBaselineToTopHeight()
   * @see #setLastBaselineToBottomHeight(int)
   * @see #setPadding(int, int, int, int)
   * @see #setPaddingRelative(int, int, int, int)
   *
   * @attr ref android.R.styleable#TextView_firstBaselineToTopHeight
   */
  public void setFirstBaselineToTopHeight(@Px @IntRange(from = 0) int firstBaselineToTopHeight) {
    Preconditions.checkArgumentNonnegative(firstBaselineToTopHeight);

    final FontMetricsInt fontMetrics = getPaint().getFontMetricsInt();
    final int fontMetricsTop;
    if (getIncludeFontPadding()) {
      fontMetricsTop = fontMetrics.top;
    } else {
      fontMetricsTop = fontMetrics.ascent;
    }

    // TODO: Decide if we want to ignore density ratio (i.e. when the user changes font size
    // in settings). At the moment, we don't.

    if (firstBaselineToTopHeight > Math.abs(fontMetricsTop)) {
      final int paddingTop = firstBaselineToTopHeight - (-fontMetricsTop);
      setPadding(getPaddingLeft(), paddingTop, getPaddingRight(), getPaddingBottom());
    }
  }

  /**
   * Updates the bottom padding of the TextView so that {@code lastBaselineToBottomHeight} is
   * the distance between the bottom of the TextView and the last line's baseline.
   * <p>
   * <img src="{@docRoot}reference/android/images/text/widget/first_last_baseline.png" />
   * <figcaption>First and last baseline metrics for a TextView.</figcaption>
   *
   * <strong>Note</strong> that if {@code FontMetrics.bottom} or {@code FontMetrics.descent} was
   * already greater than {@code lastBaselineToBottomHeight}, the bottom padding is not updated.
   * Moreover since this function sets the bottom padding, if the height of the TextView is less
   * than the sum of top padding, line height and bottom padding, bottom of the text will be
   * clipped.
   *
   * @param lastBaselineToBottomHeight distance between last baseline to bottom of the container
   *      in pixels
   *
   * @see #getLastBaselineToBottomHeight()
   * @see #setFirstBaselineToTopHeight(int)
   * @see #setPadding(int, int, int, int)
   * @see #setPaddingRelative(int, int, int, int)
   *
   * @attr ref android.R.styleable#TextView_lastBaselineToBottomHeight
   */
  public void setLastBaselineToBottomHeight(
    @Px @IntRange(from = 0) int lastBaselineToBottomHeight) {
    Preconditions.checkArgumentNonnegative(lastBaselineToBottomHeight);

    final FontMetricsInt fontMetrics = getPaint().getFontMetricsInt();
    final int fontMetricsBottom;
    if (getIncludeFontPadding()) {
      fontMetricsBottom = fontMetrics.bottom;
    } else {
      fontMetricsBottom = fontMetrics.descent;
    }

    // TODO: Decide if we want to ignore density ratio (i.e. when the user changes font size
    // in settings). At the moment, we don't.

    if (lastBaselineToBottomHeight > Math.abs(fontMetricsBottom)) {
      final int paddingBottom = lastBaselineToBottomHeight - fontMetricsBottom;
      setPadding(getPaddingLeft(), getPaddingTop(), getPaddingRight(), paddingBottom);
    }
  }

  /**
   * Returns the distance between the first text baseline and the top of this TextView.
   *
   * @see #setFirstBaselineToTopHeight(int)
   * @attr ref android.R.styleable#TextView_firstBaselineToTopHeight
   */
  @InspectableProperty
  public int getFirstBaselineToTopHeight() {
    return getPaddingTop() - getPaint().getFontMetricsInt().top;
  }

  /**
   * Returns the distance between the last text baseline and the bottom of this TextView.
   *
   * @see #setLastBaselineToBottomHeight(int)
   * @attr ref android.R.styleable#TextView_lastBaselineToBottomHeight
   */
  @InspectableProperty
  public int getLastBaselineToBottomHeight() {
    return getPaddingBottom() + getPaint().getFontMetricsInt().bottom;
  }

  /**
   * Gets the autolink mask of the text.
   *
   * See {@link Linkify#ALL} and peers for possible values.
   *
   * @attr ref android.R.styleable#TextView_autoLink
   */
  @InspectableProperty(name = "autoLink", flagMapping = {
    @FlagEntry(name = "web", target = Linkify.WEB_URLS),
    @FlagEntry(name = "email", target = Linkify.EMAIL_ADDRESSES),
    @FlagEntry(name = "phone", target = Linkify.PHONE_NUMBERS),
    @FlagEntry(name = "map", target = Linkify.MAP_ADDRESSES)
  })
  public final int getAutoLinkMask() {
    return mAutoLinkMask;
  }

  /**
   * Sets the Drawable corresponding to the selection handle used for
   * positioning the cursor within text. The Drawable defaults to the value
   * of the textSelectHandle attribute.
   * Note that any change applied to the handle Drawable will not be visible
   * until the handle is hidden and then drawn again.
   *
   * @see #setTextSelectHandle(int)
   * @attr ref android.R.styleable#TextView_textSelectHandle
   */
  @android.view.RemotableViewMethod
  public void setTextSelectHandle(@NonNull Drawable textSelectHandle) {
    Preconditions.checkNotNull(textSelectHandle,
                               "The text select handle should not be null.");
    mTextSelectHandle = textSelectHandle;
    mTextSelectHandleRes = 0;
    if (mEditor != null) {
      mEditor.loadHandleDrawables(true /* overwrite */);
    }
  }

  /**
   * Sets the Drawable corresponding to the selection handle used for
   * positioning the cursor within text. The Drawable defaults to the value
   * of the textSelectHandle attribute.
   * Note that any change applied to the handle Drawable will not be visible
   * until the handle is hidden and then drawn again.
   *
   * @see #setTextSelectHandle(Drawable)
   * @attr ref android.R.styleable#TextView_textSelectHandle
   */
  @android.view.RemotableViewMethod
  public void setTextSelectHandle(@DrawableRes int textSelectHandle) {
    Preconditions.checkArgument(textSelectHandle != 0,
                                "The text select handle should be a valid drawable resource id.");
    setTextSelectHandle(mContext.getDrawable(textSelectHandle));
  }

  /**
   * Returns the Drawable corresponding to the selection handle used
   * for positioning the cursor within text.
   * Note that any change applied to the handle Drawable will not be visible
   * until the handle is hidden and then drawn again.
   *
   * @return the text select handle drawable
   *
   * @see #setTextSelectHandle(Drawable)
   * @see #setTextSelectHandle(int)
   * @attr ref android.R.styleable#TextView_textSelectHandle
   */
  @Nullable public Drawable getTextSelectHandle() {
    if (mTextSelectHandle == null && mTextSelectHandleRes != 0) {
      mTextSelectHandle = mContext.getDrawable(mTextSelectHandleRes);
    }
    return mTextSelectHandle;
  }

  /**
   * Sets the Drawable corresponding to the left handle used
   * for selecting text. The Drawable defaults to the value of the
   * textSelectHandleLeft attribute.
   * Note that any change applied to the handle Drawable will not be visible
   * until the handle is hidden and then drawn again.
   *
   * @see #setTextSelectHandleLeft(int)
   * @attr ref android.R.styleable#TextView_textSelectHandleLeft
   */
  @android.view.RemotableViewMethod
  public void setTextSelectHandleLeft(@NonNull Drawable textSelectHandleLeft) {
    Preconditions.checkNotNull(textSelectHandleLeft,
                               "The left text select handle should not be null.");
    mTextSelectHandleLeft = textSelectHandleLeft;
    mTextSelectHandleLeftRes = 0;
    if (mEditor != null) {
      mEditor.loadHandleDrawables(true /* overwrite */);
    }
  }

  /**
   * Sets the Drawable corresponding to the left handle used
   * for selecting text. The Drawable defaults to the value of the
   * textSelectHandleLeft attribute.
   * Note that any change applied to the handle Drawable will not be visible
   * until the handle is hidden and then drawn again.
   *
   * @see #setTextSelectHandleLeft(Drawable)
   * @attr ref android.R.styleable#TextView_textSelectHandleLeft
   */
  @android.view.RemotableViewMethod
  public void setTextSelectHandleLeft(@DrawableRes int textSelectHandleLeft) {
    Preconditions.checkArgument(textSelectHandleLeft != 0,
                                "The text select left handle should be a valid drawable resource id.");
    setTextSelectHandleLeft(mContext.getDrawable(textSelectHandleLeft));
  }

  /**
   * Returns the Drawable corresponding to the left handle used
   * for selecting text.
   * Note that any change applied to the handle Drawable will not be visible
   * until the handle is hidden and then drawn again.
   *
   * @return the left text selection handle drawable
   *
   * @see #setTextSelectHandleLeft(Drawable)
   * @see #setTextSelectHandleLeft(int)
   * @attr ref android.R.styleable#TextView_textSelectHandleLeft
   */
  @Nullable public Drawable getTextSelectHandleLeft() {
    if (mTextSelectHandleLeft == null && mTextSelectHandleLeftRes != 0) {
      mTextSelectHandleLeft = mContext.getDrawable(mTextSelectHandleLeftRes);
    }
    return mTextSelectHandleLeft;
  }

  /**
   * Sets the Drawable corresponding to the right handle used
   * for selecting text. The Drawable defaults to the value of the
   * textSelectHandleRight attribute.
   * Note that any change applied to the handle Drawable will not be visible
   * until the handle is hidden and then drawn again.
   *
   * @see #setTextSelectHandleRight(int)
   * @attr ref android.R.styleable#TextView_textSelectHandleRight
   */
  @android.view.RemotableViewMethod
  public void setTextSelectHandleRight(@NonNull Drawable textSelectHandleRight) {
    Preconditions.checkNotNull(textSelectHandleRight,
                               "The right text select handle should not be null.");
    mTextSelectHandleRight = textSelectHandleRight;
    mTextSelectHandleRightRes = 0;
    if (mEditor != null) {
      mEditor.loadHandleDrawables(true /* overwrite */);
    }
  }

  /**
   * Sets the Drawable corresponding to the right handle used
   * for selecting text. The Drawable defaults to the value of the
   * textSelectHandleRight attribute.
   * Note that any change applied to the handle Drawable will not be visible
   * until the handle is hidden and then drawn again.
   *
   * @see #setTextSelectHandleRight(Drawable)
   * @attr ref android.R.styleable#TextView_textSelectHandleRight
   */
  @android.view.RemotableViewMethod
  public void setTextSelectHandleRight(@DrawableRes int textSelectHandleRight) {
    Preconditions.checkArgument(textSelectHandleRight != 0,
                                "The text select right handle should be a valid drawable resource id.");
    setTextSelectHandleRight(mContext.getDrawable(textSelectHandleRight));
  }

  /**
   * Returns the Drawable corresponding to the right handle used
   * for selecting text.
   * Note that any change applied to the handle Drawable will not be visible
   * until the handle is hidden and then drawn again.
   *
   * @return the right text selection handle drawable
   *
   * @see #setTextSelectHandleRight(Drawable)
   * @see #setTextSelectHandleRight(int)
   * @attr ref android.R.styleable#TextView_textSelectHandleRight
   */
  @Nullable public Drawable getTextSelectHandleRight() {
    if (mTextSelectHandleRight == null && mTextSelectHandleRightRes != 0) {
      mTextSelectHandleRight = mContext.getDrawable(mTextSelectHandleRightRes);
    }
    return mTextSelectHandleRight;
  }

  /**
   * Sets the Drawable corresponding to the text cursor. The Drawable defaults to the
   * value of the textCursorDrawable attribute.
   * Note that any change applied to the cursor Drawable will not be visible
   * until the cursor is hidden and then drawn again.
   *
   * @see #setTextCursorDrawable(int)
   * @attr ref android.R.styleable#TextView_textCursorDrawable
   */
  public void setTextCursorDrawable(@Nullable Drawable textCursorDrawable) {
    mCursorDrawable = textCursorDrawable;
    mCursorDrawableRes = 0;
    if (mEditor != null) {
      mEditor.loadCursorDrawable();
    }
  }

  /**
   * Sets the Drawable corresponding to the text cursor. The Drawable defaults to the
   * value of the textCursorDrawable attribute.
   * Note that any change applied to the cursor Drawable will not be visible
   * until the cursor is hidden and then drawn again.
   *
   * @see #setTextCursorDrawable(Drawable)
   * @attr ref android.R.styleable#TextView_textCursorDrawable
   */
  public void setTextCursorDrawable(@DrawableRes int textCursorDrawable) {
    setTextCursorDrawable(
      textCursorDrawable != 0 ? mContext.getDrawable(textCursorDrawable) : null);
  }

  /**
   * Returns the Drawable corresponding to the text cursor.
   * Note that any change applied to the cursor Drawable will not be visible
   * until the cursor is hidden and then drawn again.
   *
   * @return the text cursor drawable
   *
   * @see #setTextCursorDrawable(Drawable)
   * @see #setTextCursorDrawable(int)
   * @attr ref android.R.styleable#TextView_textCursorDrawable
   */
  @Nullable public Drawable getTextCursorDrawable() {
    if (mCursorDrawable == null && mCursorDrawableRes != 0) {
      mCursorDrawable = mContext.getDrawable(mCursorDrawableRes);
    }
    return mCursorDrawable;
  }

  /**
   * Sets the text appearance from the specified style resource.
   * <p>
   * Use a framework-defined {@code TextAppearance} style like
   * {@link android.R.style#TextAppearance_Material_Body1 @android:style/TextAppearance.Material.Body1}
   * or see {@link android.R.styleable#TextAppearance TextAppearance} for the
   * set of attributes that can be used in a custom style.
   *
   * @param resId the resource identifier of the style to apply
   * @attr ref android.R.styleable#TextView_textAppearance
   */
  @SuppressWarnings("deprecation")
  public void setTextAppearance(@StyleRes int resId) {
    setTextAppearance(mContext, resId);
  }

  /**
   * Sets the text color, size, style, hint color, and highlight color
   * from the specified TextAppearance resource.
   *
   * @deprecated Use {@link #setTextAppearance(int)} instead.
   */
  @Deprecated
  public void setTextAppearance(Context context, @StyleRes int resId) {
    final TypedArray ta = context.obtainStyledAttributes(resId, R.styleable.TextAppearance);
    final TextAppearanceAttributes attributes = new TextAppearanceAttributes();
    readTextAppearance(context, ta, attributes, false /* styleArray */);
    ta.recycle();
    applyTextAppearance(attributes);
  }

  /**
   * Set of attributes that can be defined in a Text Appearance. This is used to simplify the code
   * that reads these attributes in the constructor and in {@link #setTextAppearance}.
   */
  private static class TextAppearanceAttributes {
    int mTextColorHighlight = 0;
    int mSearchResultHighlightColor = 0;
    int mFocusedSearchResultHighlightColor = 0;
    ColorStateList mTextColor = null;
    ColorStateList mTextColorHint = null;
    ColorStateList mTextColorLink = null;
    int mTextSize = -1;
    int mTextSizeUnit = -1;
    LocaleList mTextLocales = null;
    String mFontFamily = null;
    Typeface mFontTypeface = null;
    boolean mFontFamilyExplicit = false;
    int mTypefaceIndex = -1;
    int mTextStyle = 0;
    int mFontWeight = FontStyle.FONT_WEIGHT_UNSPECIFIED;
    boolean mAllCaps = false;
    int mShadowColor = 0;
    float mShadowDx = 0, mShadowDy = 0, mShadowRadius = 0;
    boolean mHasElegant = false;
    boolean mElegant = false;
    boolean mHasFallbackLineSpacing = false;
    boolean mFallbackLineSpacing = false;
    boolean mHasLetterSpacing = false;
    float mLetterSpacing = 0;
    String mFontFeatureSettings = null;
    String mFontVariationSettings = null;
    boolean mHasLineBreakStyle = false;
    boolean mHasLineBreakWordStyle = false;
    int mLineBreakStyle = DEFAULT_LINE_BREAK_STYLE;
    int mLineBreakWordStyle = DEFAULT_LINE_BREAK_WORD_STYLE;

    @Override
    public String toString() {
      return "TextAppearanceAttributes {\n"
             + "    mTextColorHighlight:" + mTextColorHighlight + "\n"
             + "    mSearchResultHighlightColor: " + mSearchResultHighlightColor + "\n"
             + "    mFocusedSearchResultHighlightColor: "
             + mFocusedSearchResultHighlightColor + "\n"
             + "    mTextColor:" + mTextColor + "\n"
             + "    mTextColorHint:" + mTextColorHint + "\n"
             + "    mTextColorLink:" + mTextColorLink + "\n"
             + "    mTextSize:" + mTextSize + "\n"
             + "    mTextSizeUnit:" + mTextSizeUnit + "\n"
             + "    mTextLocales:" + mTextLocales + "\n"
             + "    mFontFamily:" + mFontFamily + "\n"
             + "    mFontTypeface:" + mFontTypeface + "\n"
             + "    mFontFamilyExplicit:" + mFontFamilyExplicit + "\n"
             + "    mTypefaceIndex:" + mTypefaceIndex + "\n"
             + "    mTextStyle:" + mTextStyle + "\n"
             + "    mFontWeight:" + mFontWeight + "\n"
             + "    mAllCaps:" + mAllCaps + "\n"
             + "    mShadowColor:" + mShadowColor + "\n"
             + "    mShadowDx:" + mShadowDx + "\n"
             + "    mShadowDy:" + mShadowDy + "\n"
             + "    mShadowRadius:" + mShadowRadius + "\n"
             + "    mHasElegant:" + mHasElegant + "\n"
             + "    mElegant:" + mElegant + "\n"
             + "    mHasFallbackLineSpacing:" + mHasFallbackLineSpacing + "\n"
             + "    mFallbackLineSpacing:" + mFallbackLineSpacing + "\n"
             + "    mHasLetterSpacing:" + mHasLetterSpacing + "\n"
             + "    mLetterSpacing:" + mLetterSpacing + "\n"
             + "    mFontFeatureSettings:" + mFontFeatureSettings + "\n"
             + "    mFontVariationSettings:" + mFontVariationSettings + "\n"
             + "    mHasLineBreakStyle:" + mHasLineBreakStyle + "\n"
             + "    mHasLineBreakWordStyle:" + mHasLineBreakWordStyle + "\n"
             + "    mLineBreakStyle:" + mLineBreakStyle + "\n"
             + "    mLineBreakWordStyle:" + mLineBreakWordStyle + "\n"
             + "}";
    }
  }

  // Maps styleable attributes that exist both in TextView style and TextAppearance.
  private static final SparseIntArray sAppearanceValues = new SparseIntArray();
  static {
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_textColorHighlight,
                          com.android.internal.R.styleable.TextAppearance_textColorHighlight);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_searchResultHighlightColor,
                          com.android.internal.R.styleable.TextAppearance_searchResultHighlightColor);
    sAppearanceValues.put(
      com.android.internal.R.styleable.TextView_focusedSearchResultHighlightColor,
      com.android.internal.R.styleable.TextAppearance_focusedSearchResultHighlightColor);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_textColor,
                          com.android.internal.R.styleable.TextAppearance_textColor);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_textColorHint,
                          com.android.internal.R.styleable.TextAppearance_textColorHint);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_textColorLink,
                          com.android.internal.R.styleable.TextAppearance_textColorLink);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_textSize,
                          com.android.internal.R.styleable.TextAppearance_textSize);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_textLocale,
                          com.android.internal.R.styleable.TextAppearance_textLocale);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_typeface,
                          com.android.internal.R.styleable.TextAppearance_typeface);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_fontFamily,
                          com.android.internal.R.styleable.TextAppearance_fontFamily);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_textStyle,
                          com.android.internal.R.styleable.TextAppearance_textStyle);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_textFontWeight,
                          com.android.internal.R.styleable.TextAppearance_textFontWeight);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_textAllCaps,
                          com.android.internal.R.styleable.TextAppearance_textAllCaps);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_shadowColor,
                          com.android.internal.R.styleable.TextAppearance_shadowColor);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_shadowDx,
                          com.android.internal.R.styleable.TextAppearance_shadowDx);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_shadowDy,
                          com.android.internal.R.styleable.TextAppearance_shadowDy);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_shadowRadius,
                          com.android.internal.R.styleable.TextAppearance_shadowRadius);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_elegantTextHeight,
                          com.android.internal.R.styleable.TextAppearance_elegantTextHeight);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_fallbackLineSpacing,
                          com.android.internal.R.styleable.TextAppearance_fallbackLineSpacing);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_letterSpacing,
                          com.android.internal.R.styleable.TextAppearance_letterSpacing);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_fontFeatureSettings,
                          com.android.internal.R.styleable.TextAppearance_fontFeatureSettings);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_fontVariationSettings,
                          com.android.internal.R.styleable.TextAppearance_fontVariationSettings);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_lineBreakStyle,
                          com.android.internal.R.styleable.TextAppearance_lineBreakStyle);
    sAppearanceValues.put(com.android.internal.R.styleable.TextView_lineBreakWordStyle,
                          com.android.internal.R.styleable.TextAppearance_lineBreakWordStyle);
  }

  /**
   * Read the Text Appearance attributes from a given TypedArray and set its values to the given
   * set. If the TypedArray contains a value that was already set in the given attributes, that
   * will be overridden.
   *
   * @param context The Context to be used
   * @param appearance The TypedArray to read properties from
   * @param attributes the TextAppearanceAttributes to fill in
   * @param styleArray Whether the given TypedArray is a style or a TextAppearance. This defines
   *                   what attribute indexes will be used to read the properties.
   */
  private void readTextAppearance(Context context, TypedArray appearance,
                                  TextAppearanceAttributes attributes, boolean styleArray) {
    final int n = appearance.getIndexCount();
    for (int i = 0; i < n; i++) {
      final int attr = appearance.getIndex(i);
      int index = attr;
      // Translate style array index ids to TextAppearance ids.
      if (styleArray) {
        index = sAppearanceValues.get(attr, -1);
        if (index == -1) {
          // This value is not part of a Text Appearance and should be ignored.
          continue;
        }
      }
      switch (index) {
        case com.android.internal.R.styleable.TextAppearance_textColorHighlight:
          attributes.mTextColorHighlight =
            appearance.getColor(attr, attributes.mTextColorHighlight);
          break;
        case com.android.internal.R.styleable.TextAppearance_searchResultHighlightColor:
          attributes.mSearchResultHighlightColor =
            appearance.getColor(attr, attributes.mSearchResultHighlightColor);
          break;
        case com.android.internal.R.styleable
               .TextAppearance_focusedSearchResultHighlightColor:
          attributes.mFocusedSearchResultHighlightColor =
            appearance.getColor(attr,
                                attributes.mFocusedSearchResultHighlightColor);
          break;
        case com.android.internal.R.styleable.TextAppearance_textColor:
          attributes.mTextColor = appearance.getColorStateList(attr);
          break;
        case com.android.internal.R.styleable.TextAppearance_textColorHint:
          attributes.mTextColorHint = appearance.getColorStateList(attr);
          break;
        case com.android.internal.R.styleable.TextAppearance_textColorLink:
          attributes.mTextColorLink = appearance.getColorStateList(attr);
          break;
        case com.android.internal.R.styleable.TextAppearance_textSize:
          attributes.mTextSize =
            appearance.getDimensionPixelSize(attr, attributes.mTextSize);
          attributes.mTextSizeUnit = appearance.peekValue(attr).getComplexUnit();
          break;
        case com.android.internal.R.styleable.TextAppearance_textLocale:
          final String localeString = appearance.getString(attr);
          if (localeString != null) {
            final LocaleList localeList = LocaleList.forLanguageTags(localeString);
            if (!localeList.isEmpty()) {
              attributes.mTextLocales = localeList;
            }
          }
          break;
        case com.android.internal.R.styleable.TextAppearance_typeface:
          attributes.mTypefaceIndex = appearance.getInt(attr, attributes.mTypefaceIndex);
          if (attributes.mTypefaceIndex != -1 && !attributes.mFontFamilyExplicit) {
            attributes.mFontFamily = null;
          }
          break;
        case com.android.internal.R.styleable.TextAppearance_fontFamily:
          if (!context.isRestricted() && context.canLoadUnsafeResources()) {
            try {
              attributes.mFontTypeface = appearance.getFont(attr);
            } catch (UnsupportedOperationException | Resources.NotFoundException e) {
              // Expected if it is not a font resource.
            }
          }
          if (attributes.mFontTypeface == null) {
            attributes.mFontFamily = appearance.getString(attr);
          }
          attributes.mFontFamilyExplicit = true;
          break;
        case com.android.internal.R.styleable.TextAppearance_textStyle:
          attributes.mTextStyle = appearance.getInt(attr, attributes.mTextStyle);
          break;
        case com.android.internal.R.styleable.TextAppearance_textFontWeight:
          attributes.mFontWeight = appearance.getInt(attr, attributes.mFontWeight);
          break;
        case com.android.internal.R.styleable.TextAppearance_textAllCaps:
          attributes.mAllCaps = appearance.getBoolean(attr, attributes.mAllCaps);
          break;
        case com.android.internal.R.styleable.TextAppearance_shadowColor:
          attributes.mShadowColor = appearance.getInt(attr, attributes.mShadowColor);
          break;
        case com.android.internal.R.styleable.TextAppearance_shadowDx:
          attributes.mShadowDx = appearance.getFloat(attr, attributes.mShadowDx);
          break;
        case com.android.internal.R.styleable.TextAppearance_shadowDy:
          attributes.mShadowDy = appearance.getFloat(attr, attributes.mShadowDy);
          break;
        case com.android.internal.R.styleable.TextAppearance_shadowRadius:
          attributes.mShadowRadius = appearance.getFloat(attr, attributes.mShadowRadius);
          break;
        case com.android.internal.R.styleable.TextAppearance_elegantTextHeight:
          attributes.mHasElegant = true;
          attributes.mElegant = appearance.getBoolean(attr, attributes.mElegant);
          break;
        case com.android.internal.R.styleable.TextAppearance_fallbackLineSpacing:
          attributes.mHasFallbackLineSpacing = true;
          attributes.mFallbackLineSpacing = appearance.getBoolean(attr,
                                                                  attributes.mFallbackLineSpacing);
          break;
        case com.android.internal.R.styleable.TextAppearance_letterSpacing:
          attributes.mHasLetterSpacing = true;
          attributes.mLetterSpacing =
            appearance.getFloat(attr, attributes.mLetterSpacing);
          break;
        case com.android.internal.R.styleable.TextAppearance_fontFeatureSettings:
          attributes.mFontFeatureSettings = appearance.getString(attr);
          break;
        case com.android.internal.R.styleable.TextAppearance_fontVariationSettings:
          attributes.mFontVariationSettings = appearance.getString(attr);
          break;
        case com.android.internal.R.styleable.TextAppearance_lineBreakStyle:
          attributes.mHasLineBreakStyle = true;
          attributes.mLineBreakStyle =
            appearance.getInt(attr, attributes.mLineBreakStyle);
          break;
        case com.android.internal.R.styleable.TextAppearance_lineBreakWordStyle:
          attributes.mHasLineBreakWordStyle = true;
          attributes.mLineBreakWordStyle =
            appearance.getInt(attr, attributes.mLineBreakWordStyle);
          break;
        default:
      }
    }
  }

  private void applyTextAppearance(TextAppearanceAttributes attributes) {
    if (attributes.mTextColor != null) {
      setTextColor(attributes.mTextColor);
    }

    if (attributes.mTextColorHint != null) {
      setHintTextColor(attributes.mTextColorHint);
    }

    if (attributes.mTextColorLink != null) {
      setLinkTextColor(attributes.mTextColorLink);
    }

    if (attributes.mTextColorHighlight != 0) {
      setHighlightColor(attributes.mTextColorHighlight);
    }

    if (attributes.mSearchResultHighlightColor != 0) {
      setSearchResultHighlightColor(attributes.mSearchResultHighlightColor);
    }

    if (attributes.mFocusedSearchResultHighlightColor != 0) {
      setFocusedSearchResultHighlightColor(attributes.mFocusedSearchResultHighlightColor);
    }

    if (attributes.mTextSize != -1) {
      mTextSizeUnit = attributes.mTextSizeUnit;
      setRawTextSize(attributes.mTextSize, true /* shouldRequestLayout */);
    }

    if (attributes.mTextLocales != null) {
      setTextLocales(attributes.mTextLocales);
    }

    if (attributes.mTypefaceIndex != -1 && !attributes.mFontFamilyExplicit) {
      attributes.mFontFamily = null;
    }
    setTypefaceFromAttrs(attributes.mFontTypeface, attributes.mFontFamily,
                         attributes.mTypefaceIndex, attributes.mTextStyle, attributes.mFontWeight);

    if (attributes.mShadowColor != 0) {
      setShadowLayer(attributes.mShadowRadius, attributes.mShadowDx, attributes.mShadowDy,
                     attributes.mShadowColor);
    }

    if (attributes.mAllCaps) {
      setTransformationMethod(new AllCapsTransformationMethod(getContext()));
    }

    if (attributes.mHasElegant) {
      setElegantTextHeight(attributes.mElegant);
    }

    if (attributes.mHasFallbackLineSpacing) {
      setFallbackLineSpacing(attributes.mFallbackLineSpacing);
    }

    if (attributes.mHasLetterSpacing) {
      setLetterSpacing(attributes.mLetterSpacing);
    }

    if (attributes.mFontFeatureSettings != null) {
      setFontFeatureSettings(attributes.mFontFeatureSettings);
    }

    if (attributes.mFontVariationSettings != null) {
      setFontVariationSettings(attributes.mFontVariationSettings);
    }

    if (attributes.mHasLineBreakStyle || attributes.mHasLineBreakWordStyle) {
      updateLineBreakConfigFromTextAppearance(attributes.mHasLineBreakStyle,
                                              attributes.mHasLineBreakWordStyle, attributes.mLineBreakStyle,
                                              attributes.mLineBreakWordStyle);
    }
  }

  /**
   * Updates the LineBreakConfig from the TextAppearance.
   *
   * This method updates the given line configuration from the TextAppearance. This method will
   * request new layout if line break config has been changed.
   *
   * @param isLineBreakStyleSpecified true if the line break style is specified.
   * @param isLineBreakWordStyleSpecified true if the line break word style is specified.
   * @param lineBreakStyle the value of the line break style in the TextAppearance.
   * @param lineBreakWordStyle the value of the line break word style in the TextAppearance.
   */
  private void updateLineBreakConfigFromTextAppearance(boolean isLineBreakStyleSpecified,
                                                       boolean isLineBreakWordStyleSpecified,
                                                       @LineBreakConfig.LineBreakStyle int lineBreakStyle,
                                                       @LineBreakConfig.LineBreakWordStyle int lineBreakWordStyle) {
    boolean updated = false;
    if (isLineBreakStyleSpecified && mLineBreakStyle != lineBreakStyle) {
      mLineBreakStyle = lineBreakStyle;
      updated = true;
    }
    if (isLineBreakWordStyleSpecified && mLineBreakWordStyle != lineBreakWordStyle) {
      mLineBreakWordStyle = lineBreakWordStyle;
      updated = true;
    }
    if (updated && mLayout != null) {
      nullLayouts();
      requestLayout();
      invalidate();
    }
  }
  /**
   * Get the default primary {@link Locale} of the text in this TextView. This will always be
   * the first member of {@link #getTextLocales()}.
   * @return the default primary {@link Locale} of the text in this TextView.
   */
  @NonNull
  public Locale getTextLocale() {
    return mTextPaint.getTextLocale();
  }

  /**
   * Get the default {@link LocaleList} of the text in this TextView.
   * @return the default {@link LocaleList} of the text in this TextView.
   */
  @NonNull @Size(min = 1)
  public LocaleList getTextLocales() {
    return mTextPaint.getTextLocales();
  }

  private void changeListenerLocaleTo(@Nullable Locale locale) {
    if (mListenerChanged) {
      // If a listener has been explicitly set, don't change it. We may break something.
      return;
    }
    // The following null check is not absolutely necessary since all calling points of
    // changeListenerLocaleTo() guarantee a non-null mEditor at the moment. But this is left
    // here in case others would want to call this method in the future.
    if (mEditor != null) {
      KeyListener listener = mEditor.mKeyListener;
      if (listener instanceof DigitsKeyListener) {
        listener = DigitsKeyListener.getInstance(locale, (DigitsKeyListener) listener);
      } else if (listener instanceof DateKeyListener) {
        listener = DateKeyListener.getInstance(locale);
      } else if (listener instanceof TimeKeyListener) {
        listener = TimeKeyListener.getInstance(locale);
      } else if (listener instanceof DateTimeKeyListener) {
        listener = DateTimeKeyListener.getInstance(locale);
      } else {
        return;
      }
      final boolean wasPasswordType = isPasswordInputType(mEditor.mInputType);
      setKeyListenerOnly(listener);
      setInputTypeFromEditor();
      if (wasPasswordType) {
        final int newInputClass = mEditor.mInputType & EditorInfo.TYPE_MASK_CLASS;
        if (newInputClass == EditorInfo.TYPE_CLASS_TEXT) {
          mEditor.mInputType |= EditorInfo.TYPE_TEXT_VARIATION_PASSWORD;
        } else if (newInputClass == EditorInfo.TYPE_CLASS_NUMBER) {
          mEditor.mInputType |= EditorInfo.TYPE_NUMBER_VARIATION_PASSWORD;
        }
      }
    }
  }

  /**
   * Set the default {@link Locale} of the text in this TextView to a one-member
   * {@link LocaleList} containing just the given Locale.
   *
   * @param locale the {@link Locale} for drawing text, must not be null.
   *
   * @see #setTextLocales
   */
  public void setTextLocale(@NonNull Locale locale) {
    mLocalesChanged = true;
    mTextPaint.setTextLocale(locale);
    if (mLayout != null) {
      nullLayouts();
      requestLayout();
      invalidate();
    }
  }

  /**
   * Set the default {@link LocaleList} of the text in this TextView to the given value.
   *
   * This value is used to choose appropriate typefaces for ambiguous characters (typically used
   * for CJK locales to disambiguate Hanzi/Kanji/Hanja characters). It also affects
   * other aspects of text display, including line breaking.
   *
   * @param locales the {@link LocaleList} for drawing text, must not be null or empty.
   *
   * @see Paint#setTextLocales
   */
  public void setTextLocales(@NonNull @Size(min = 1) LocaleList locales) {
    mLocalesChanged = true;
    mTextPaint.setTextLocales(locales);
    if (mLayout != null) {
      nullLayouts();
      requestLayout();
      invalidate();
    }
  }

  @Override
  protected void onConfigurationChanged(Configuration newConfig) {
    super.onConfigurationChanged(newConfig);
    if (!mLocalesChanged) {
      mTextPaint.setTextLocales(LocaleList.getDefault());
      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
    if (mFontWeightAdjustment != newConfig.fontWeightAdjustment) {
      mFontWeightAdjustment = newConfig.fontWeightAdjustment;
      setTypeface(getTypeface());
    }

    InputMethodManager imm = getInputMethodManager();
    // if orientation changed and this TextView is currently served.
    if (mLastOrientation != newConfig.orientation
        && imm != null && imm.hasActiveInputConnection(this)) {
      // EditorInfo.internalImeOptions are out of date.
      imm.restartInput(this);
    }
    mLastOrientation = newConfig.orientation;
  }

  /**
   * @return the size (in pixels) of the default text size in this TextView.
   */
  @InspectableProperty
  @ViewDebug.ExportedProperty(category = "text")
  public float getTextSize() {
    return mTextPaint.getTextSize();
  }

  /**
   * @return the size (in scaled pixels) of the default text size in this TextView.
   * @hide
   */
  @ViewDebug.ExportedProperty(category = "text")
  public float getScaledTextSize() {
    return mTextPaint.getTextSize() / mTextPaint.density;
  }

  /** @hide */
  @ViewDebug.ExportedProperty(category = "text", mapping = {
    @ViewDebug.IntToString(from = Typeface.NORMAL, to = "NORMAL"),
    @ViewDebug.IntToString(from = Typeface.BOLD, to = "BOLD"),
    @ViewDebug.IntToString(from = Typeface.ITALIC, to = "ITALIC"),
    @ViewDebug.IntToString(from = Typeface.BOLD_ITALIC, to = "BOLD_ITALIC")
  })
  public int getTypefaceStyle() {
    Typeface typeface = mTextPaint.getTypeface();
    return typeface != null ? typeface.getStyle() : Typeface.NORMAL;
  }

  /**
   * Set the default text size to the given value, interpreted as "scaled
   * pixel" units.  This size is adjusted based on the current density and
   * user font size preference.
   *
   * <p>Note: if this TextView has the auto-size feature enabled, then this function is no-op.
   *
   * @param size The scaled pixel size.
   *
   * @attr ref android.R.styleable#TextView_textSize
   */
  @android.view.RemotableViewMethod
  public void setTextSize(float size) {
    setTextSize(TypedValue.COMPLEX_UNIT_SP, size);
  }

  /**
   * Set the default text size to a given unit and value. See {@link
   * TypedValue} for the possible dimension units.
   *
   * <p>Note: if this TextView has the auto-size feature enabled, then this function is no-op.
   *
   * @param unit The desired dimension unit.
   * @param size The desired size in the given units.
   *
   * @attr ref android.R.styleable#TextView_textSize
   */
  public void setTextSize(int unit, float size) {
    if (!isAutoSizeEnabled()) {
      setTextSizeInternal(unit, size, true /* shouldRequestLayout */);
    }
  }

  @NonNull
  private DisplayMetrics getDisplayMetricsOrSystem() {
    Context c = getContext();
    Resources r;

    if (c == null) {
      r = Resources.getSystem();
    } else {
      r = c.getResources();
    }

    return r.getDisplayMetrics();
  }

  private void setTextSizeInternal(int unit, float size, boolean shouldRequestLayout) {
    mTextSizeUnit = unit;
    setRawTextSize(TypedValue.applyDimension(unit, size, getDisplayMetricsOrSystem()),
                   shouldRequestLayout);
  }

  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
  private void setRawTextSize(float size, boolean shouldRequestLayout) {
    if (size != mTextPaint.getTextSize()) {
      mTextPaint.setTextSize(size);

      maybeRecalculateLineHeight();
      if (shouldRequestLayout && mLayout != null) {
        // Do not auto-size right after setting the text size.
        mNeedsAutoSizeText = false;
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Gets the text size unit defined by the developer. It may be specified in resources or be
   * passed as the unit argument of {@link #setTextSize(int, float)} at runtime.
   *
   * @return the dimension type of the text size unit originally defined.
   * @see TypedValue#TYPE_DIMENSION
   */
  public int getTextSizeUnit() {
    return mTextSizeUnit;
  }

  /**
   * Gets the extent by which text should be stretched horizontally.
   * This will usually be 1.0.
   * @return The horizontal scale factor.
   */
  @InspectableProperty
  public float getTextScaleX() {
    return mTextPaint.getTextScaleX();
  }

  /**
   * Sets the horizontal scale factor for text. The default value
   * is 1.0. Values greater than 1.0 stretch the text wider.
   * Values less than 1.0 make the text narrower. By default, this value is 1.0.
   * @param size The horizontal scale factor.
   * @attr ref android.R.styleable#TextView_textScaleX
   */
  @android.view.RemotableViewMethod
  public void setTextScaleX(float size) {
    if (size != mTextPaint.getTextScaleX()) {
      mUserSetTextScaleX = true;
      mTextPaint.setTextScaleX(size);

      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Sets the typeface and style in which the text should be displayed.
   * Note that not all Typeface families actually have bold and italic
   * variants, so you may need to use
   * {@link #setTypeface(Typeface, int)} to get the appearance
   * that you actually want.
   *
   * @see #getTypeface()
   *
   * @attr ref android.R.styleable#TextView_fontFamily
   * @attr ref android.R.styleable#TextView_typeface
   * @attr ref android.R.styleable#TextView_textStyle
   */
  public void setTypeface(@Nullable Typeface tf) {
    mOriginalTypeface = tf;
    if (mFontWeightAdjustment != 0
        && mFontWeightAdjustment != Configuration.FONT_WEIGHT_ADJUSTMENT_UNDEFINED) {
      if (tf == null) {
        tf = Typeface.DEFAULT;
      } else {
        int newWeight = Math.min(
          Math.max(tf.getWeight() + mFontWeightAdjustment, FontStyle.FONT_WEIGHT_MIN),
          FontStyle.FONT_WEIGHT_MAX);
        int typefaceStyle = tf != null ? tf.getStyle() : 0;
        boolean italic = (typefaceStyle & Typeface.ITALIC) != 0;
        tf = Typeface.create(tf, newWeight, italic);
      }
    }
    if (mTextPaint.getTypeface() != tf) {
      mTextPaint.setTypeface(tf);

      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Gets the current {@link Typeface} that is used to style the text.
   * @return The current Typeface.
   *
   * @see #setTypeface(Typeface)
   *
   * @attr ref android.R.styleable#TextView_fontFamily
   * @attr ref android.R.styleable#TextView_typeface
   * @attr ref android.R.styleable#TextView_textStyle
   */
  @InspectableProperty
  public Typeface getTypeface() {
    return mOriginalTypeface;
  }

  /**
   * Set the TextView's elegant height metrics flag. This setting selects font
   * variants that have not been compacted to fit Latin-based vertical
   * metrics, and also increases top and bottom bounds to provide more space.
   *
   * @param elegant set the paint's elegant metrics flag.
   *
   * @see #isElegantTextHeight()
   * @see Paint#isElegantTextHeight()
   *
   * @attr ref android.R.styleable#TextView_elegantTextHeight
   */
  public void setElegantTextHeight(boolean elegant) {
    if (elegant != mTextPaint.isElegantTextHeight()) {
      mTextPaint.setElegantTextHeight(elegant);
      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Set whether to respect the ascent and descent of the fallback fonts that are used in
   * displaying the text (which is needed to avoid text from consecutive lines running into
   * each other). If set, fallback fonts that end up getting used can increase the ascent
   * and descent of the lines that they are used on.
   * <p/>
   * It is required to be true if text could be in languages like Burmese or Tibetan where text
   * is typically much taller or deeper than Latin text.
   *
   * @param enabled whether to expand linespacing based on fallback fonts, {@code true} by default
   *
   * @see StaticLayout.Builder#setUseLineSpacingFromFallbacks(boolean)
   *
   * @attr ref android.R.styleable#TextView_fallbackLineSpacing
   */
  public void setFallbackLineSpacing(boolean enabled) {
    int fallbackStrategy;
    if (enabled) {
      if (CompatChanges.isChangeEnabled(BORINGLAYOUT_FALLBACK_LINESPACING)) {
        fallbackStrategy = FALLBACK_LINE_SPACING_ALL;
      } else {
        fallbackStrategy = FALLBACK_LINE_SPACING_STATIC_LAYOUT_ONLY;
      }
    } else {
      fallbackStrategy = FALLBACK_LINE_SPACING_NONE;
    }
    if (mUseFallbackLineSpacing != fallbackStrategy) {
      mUseFallbackLineSpacing = fallbackStrategy;
      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Set true for using width of bounding box as a source of automatic line breaking and drawing.
   *
   * If this value is false, the TextView determines the View width, drawing offset and automatic
   * line breaking based on total advances as text widths. By setting true, use glyph bound's as a
   * source of text width.
   *
   * If the font used for this TextView has glyphs that has negative bearing X or glyph xMax is
   * greater than advance, the glyph clipping can be happened because the drawing area may be
   * bigger than advance. By setting this to true, the TextView will reserve more spaces for
   * drawing are, so clipping can be prevented.
   *
   * This value is true by default if the target API version is 35 or later.
   *
   * @param useBoundsForWidth true for using bounding box for width. false for using advances for
   *                          width.
   * @see #getUseBoundsForWidth()
   * @see #setShiftDrawingOffsetForStartOverhang(boolean)
   * @see #getShiftDrawingOffsetForStartOverhang()
   */
  @FlaggedApi(FLAG_USE_BOUNDS_FOR_WIDTH)
  public void setUseBoundsForWidth(boolean useBoundsForWidth) {
    if (mUseBoundsForWidth != useBoundsForWidth) {
      mUseBoundsForWidth = useBoundsForWidth;
      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Returns true if using bounding box as a width, false for using advance as a width.
   *
   * @see #setUseBoundsForWidth(boolean)
   * @see #setShiftDrawingOffsetForStartOverhang(boolean)
   * @see #getShiftDrawingOffsetForStartOverhang()
   * @return True if using bounding box for width, false if using advance for width.
   */
  @FlaggedApi(FLAG_USE_BOUNDS_FOR_WIDTH)
  public boolean getUseBoundsForWidth() {
    return mUseBoundsForWidth;
  }

  /**
   * Set true for shifting the drawing x offset for showing overhang at the start position.
   *
   * This flag is ignored if the {@link #getUseBoundsForWidth()} is false.
   *
   * If this value is false, the TextView draws text from the zero even if there is a glyph stroke
   * in a region where the x coordinate is negative. TextView clips the stroke in the region where
   * the X coordinate is negative unless the parents has {@link ViewGroup#getClipChildren()} to
   * true. This is useful for aligning multiple TextViews vertically.
   *
   * If this value is true, the TextView draws text with shifting the x coordinate of the drawing
   * bounding box. This prevents the clipping even if the parents doesn't have
   * {@link ViewGroup#getClipChildren()} to true.
   *
   * This value is false by default.
   *
   * @param shiftDrawingOffsetForStartOverhang true for shifting the drawing offset for showing
   *                                           the stroke that is in the region whre the x
   *                                           coorinate is negative.
   * @see #setUseBoundsForWidth(boolean)
   * @see #getUseBoundsForWidth()
   */
  @FlaggedApi(FLAG_USE_BOUNDS_FOR_WIDTH)
  public void setShiftDrawingOffsetForStartOverhang(boolean shiftDrawingOffsetForStartOverhang) {
    if (mShiftDrawingOffsetForStartOverhang != shiftDrawingOffsetForStartOverhang) {
      mShiftDrawingOffsetForStartOverhang = shiftDrawingOffsetForStartOverhang;
      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Returns true if shifting the drawing x offset for start overhang.
   *
   * @see #setShiftDrawingOffsetForStartOverhang(boolean)
   * @see #setUseBoundsForWidth(boolean)
   * @see #getUseBoundsForWidth()
   * @return True if shifting the drawing x offset for start overhang.
   */
  @FlaggedApi(FLAG_USE_BOUNDS_FOR_WIDTH)
  public boolean getShiftDrawingOffsetForStartOverhang() {
    return mShiftDrawingOffsetForStartOverhang;
  }

  /**
   * Set the minimum font metrics used for line spacing.
   *
   * <p>
   * {@code null} is the default value. If {@code null} is set or left as default, the font
   * metrics obtained by {@link Paint#getFontMetricsForLocale(Paint.FontMetrics)} is used.
   *
   * <p>
   * The minimum meaning here is the minimum value of line spacing: maximum value of
   * {@link Paint#ascent()}, minimum value of {@link Paint#descent()}.
   *
   * <p>
   * By setting this value, each line will have minimum line spacing regardless of the text
   * rendered. For example, usually Japanese script has larger vertical metrics than Latin script.
   * By setting the metrics obtained by {@link Paint#getFontMetricsForLocale(Paint.FontMetrics)}
   * for Japanese or leave it {@code null} if the TextView's locale or system locale is Japanese,
   * the line spacing for Japanese is reserved if the TextView contains English text. If the
   * vertical metrics of the text is larger than Japanese, for example Burmese, the bigger font
   * metrics is used.
   *
   * @param minimumFontMetrics A minimum font metrics. Passing {@code null} for using the value
   *                           obtained by
   *                           {@link Paint#getFontMetricsForLocale(Paint.FontMetrics)}
   * @see #getMinimumFontMetrics()
   * @see Layout#getMinimumFontMetrics()
   * @see Layout.Builder#setMinimumFontMetrics(Paint.FontMetrics)
   * @see StaticLayout.Builder#setMinimumFontMetrics(Paint.FontMetrics)
   * @see DynamicLayout.Builder#setMinimumFontMetrics(Paint.FontMetrics)
   */
  @FlaggedApi(FLAG_FIX_LINE_HEIGHT_FOR_LOCALE)
  public void setMinimumFontMetrics(@Nullable Paint.FontMetrics minimumFontMetrics) {
    mMinimumFontMetrics = minimumFontMetrics;
  }

  /**
   * Get the minimum font metrics used for line spacing.
   *
   * @see #setMinimumFontMetrics(Paint.FontMetrics)
   * @see Layout#getMinimumFontMetrics()
   * @see Layout.Builder#setMinimumFontMetrics(Paint.FontMetrics)
   * @see StaticLayout.Builder#setMinimumFontMetrics(Paint.FontMetrics)
   * @see DynamicLayout.Builder#setMinimumFontMetrics(Paint.FontMetrics)
   *
   * @return a minimum font metrics. {@code null} for using the value obtained by
   *         {@link Paint#getFontMetricsForLocale(Paint.FontMetrics)}
   */
  @Nullable
  @FlaggedApi(FLAG_FIX_LINE_HEIGHT_FOR_LOCALE)
  public Paint.FontMetrics getMinimumFontMetrics() {
    return mMinimumFontMetrics;
  }

  /**
   * Returns true if the locale preferred line height is used for the minimum line height.
   *
   * @return true if using locale preferred line height for the minimum line height. Otherwise
   *         false.
   *
   * @see #setLocalePreferredLineHeightForMinimumUsed(boolean)
   * @see #setMinimumFontMetrics(Paint.FontMetrics)
   * @see #getMinimumFontMetrics()
   */
  @FlaggedApi(FLAG_FIX_LINE_HEIGHT_FOR_LOCALE)
  public boolean isLocalePreferredLineHeightForMinimumUsed() {
    return mUseLocalePreferredLineHeightForMinimum;
  }

  /**
   * Set true if the locale preferred line height is used for the minimum line height.
   *
   * By setting this flag to true is equivalenet to call
   * {@link #setMinimumFontMetrics(Paint.FontMetrics)} with the one obtained by
   * {@link Paint#getFontMetricsForLocale(Paint.FontMetrics)}.
   *
   * If custom minimum line height was specified by
   * {@link #setMinimumFontMetrics(Paint.FontMetrics)}, this flag will be ignored.
   *
   * @param flag true for using locale preferred line height for the minimum line height.
   * @see #isLocalePreferredLineHeightForMinimumUsed()
   * @see #setMinimumFontMetrics(Paint.FontMetrics)
   * @see #getMinimumFontMetrics()
   */
  @FlaggedApi(FLAG_FIX_LINE_HEIGHT_FOR_LOCALE)
  public void setLocalePreferredLineHeightForMinimumUsed(boolean flag) {
    mUseLocalePreferredLineHeightForMinimum = flag;
  }

  /**
   * @return whether fallback line spacing is enabled, {@code true} by default
   *
   * @see #setFallbackLineSpacing(boolean)
   *
   * @attr ref android.R.styleable#TextView_fallbackLineSpacing
   */
  @InspectableProperty
  public boolean isFallbackLineSpacing() {
    return mUseFallbackLineSpacing != FALLBACK_LINE_SPACING_NONE;
  }

  private boolean isFallbackLineSpacingForBoringLayout() {
    return mUseFallbackLineSpacing == FALLBACK_LINE_SPACING_ALL;
  }

  // Package privte for accessing from Editor.java
  /* package */ boolean isFallbackLineSpacingForStaticLayout() {
    return mUseFallbackLineSpacing == FALLBACK_LINE_SPACING_ALL
           || mUseFallbackLineSpacing == FALLBACK_LINE_SPACING_STATIC_LAYOUT_ONLY;
  }

  /**
   * Get the value of the TextView's elegant height metrics flag. This setting selects font
   * variants that have not been compacted to fit Latin-based vertical
   * metrics, and also increases top and bottom bounds to provide more space.
   * @return {@code true} if the elegant height metrics flag is set.
   *
   * @see #setElegantTextHeight(boolean)
   * @see Paint#setElegantTextHeight(boolean)
   */
  @InspectableProperty
  public boolean isElegantTextHeight() {
    return mTextPaint.isElegantTextHeight();
  }

  /**
   * Gets the text letter-space value, which determines the spacing between characters.
   * The value returned is in ems. Normally, this value is 0.0.
   * @return The text letter-space value in ems.
   *
   * @see #setLetterSpacing(float)
   * @see Paint#setLetterSpacing
   */
  @InspectableProperty
  public float getLetterSpacing() {
    return mTextPaint.getLetterSpacing();
  }

  /**
   * Sets text letter-spacing in em units.  Typical values
   * for slight expansion will be around 0.05.  Negative values tighten text.
   *
   * @see #getLetterSpacing()
   * @see Paint#getLetterSpacing
   *
   * @param letterSpacing A text letter-space value in ems.
   * @attr ref android.R.styleable#TextView_letterSpacing
   */
  @android.view.RemotableViewMethod
  public void setLetterSpacing(float letterSpacing) {
    if (letterSpacing != mTextPaint.getLetterSpacing()) {
      mTextPaint.setLetterSpacing(letterSpacing);

      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Returns the font feature settings. The format is the same as the CSS
   * font-feature-settings attribute:
   * <a href="https://www.w3.org/TR/css-fonts-3/#font-feature-settings-prop">
   *     https://www.w3.org/TR/css-fonts-3/#font-feature-settings-prop</a>
   *
   * @return the currently set font feature settings.  Default is null.
   *
   * @see #setFontFeatureSettings(String)
   * @see Paint#setFontFeatureSettings(String) Paint.setFontFeatureSettings(String)
   */
  @InspectableProperty
  @Nullable
  public String getFontFeatureSettings() {
    return mTextPaint.getFontFeatureSettings();
  }

  /**
   * Returns the font variation settings.
   *
   * @return the currently set font variation settings.  Returns null if no variation is
   * specified.
   *
   * @see #setFontVariationSettings(String)
   * @see Paint#setFontVariationSettings(String) Paint.setFontVariationSettings(String)
   */
  @Nullable
  public String getFontVariationSettings() {
    return mTextPaint.getFontVariationSettings();
  }

  /**
   * Sets the break strategy for breaking paragraphs into lines. The default value for
   * TextView is {@link Layout#BREAK_STRATEGY_HIGH_QUALITY}, and the default value for
   * EditText is {@link Layout#BREAK_STRATEGY_SIMPLE}, the latter to avoid the
   * text "dancing" when being edited.
   * <p>
   * Enabling hyphenation with either using {@link Layout#HYPHENATION_FREQUENCY_NORMAL} or
   * {@link Layout#HYPHENATION_FREQUENCY_FULL} while line breaking is set to one of
   * {@link Layout#BREAK_STRATEGY_BALANCED}, {@link Layout#BREAK_STRATEGY_HIGH_QUALITY}
   * improves the structure of text layout however has performance impact and requires more time
   * to do the text layout.</p>
   * <p>
   * Compared with {@link #setLineBreakStyle(int)}, line break style with different strictness is
   * evaluated in the ICU to identify the potential breakpoints. In
   * {@link #setBreakStrategy(int)}, line break strategy handles the post processing of ICU's line
   * break result. It aims to evaluate ICU's breakpoints and break the lines based on the
   * constraint.
   * </p>
   *
   * @attr ref android.R.styleable#TextView_breakStrategy
   * @see #getBreakStrategy()
   * @see #setHyphenationFrequency(int)
   */
  public void setBreakStrategy(@Layout.BreakStrategy int breakStrategy) {
    mBreakStrategy = breakStrategy;
    if (mLayout != null) {
      nullLayouts();
      requestLayout();
      invalidate();
    }
  }

  /**
   * Gets the current strategy for breaking paragraphs into lines.
   * @return the current strategy for breaking paragraphs into lines.
   *
   * @attr ref android.R.styleable#TextView_breakStrategy
   * @see #setBreakStrategy(int)
   */
  @InspectableProperty(enumMapping = {
    @EnumEntry(name = "simple", value = Layout.BREAK_STRATEGY_SIMPLE),
    @EnumEntry(name = "high_quality", value = Layout.BREAK_STRATEGY_HIGH_QUALITY),
    @EnumEntry(name = "balanced", value = Layout.BREAK_STRATEGY_BALANCED)
  })
  @Layout.BreakStrategy
  public int getBreakStrategy() {
    return mBreakStrategy;
  }

  /**
   * Sets the frequency of automatic hyphenation to use when determining word breaks.
   * The default value for both TextView and {@link EditText} is
   * {@link Layout#HYPHENATION_FREQUENCY_NONE}. Note that the default hyphenation frequency value
   * is set from the theme.
   * <p/>
   * Enabling hyphenation with either using {@link Layout#HYPHENATION_FREQUENCY_NORMAL} or
   * {@link Layout#HYPHENATION_FREQUENCY_FULL} while line breaking is set to one of
   * {@link Layout#BREAK_STRATEGY_BALANCED}, {@link Layout#BREAK_STRATEGY_HIGH_QUALITY}
   * improves the structure of text layout however has performance impact and requires more time
   * to do the text layout.
   * <p/>
   * Note: Before Android Q, in the theme hyphenation frequency is set to
   * {@link Layout#HYPHENATION_FREQUENCY_NORMAL}. The default value is changed into
   * {@link Layout#HYPHENATION_FREQUENCY_NONE} on Q.
   *
   * @param hyphenationFrequency the hyphenation frequency to use, one of
   *                             {@link Layout#HYPHENATION_FREQUENCY_NONE},
   *                             {@link Layout#HYPHENATION_FREQUENCY_NORMAL},
   *                             {@link Layout#HYPHENATION_FREQUENCY_FULL}
   * @attr ref android.R.styleable#TextView_hyphenationFrequency
   * @see #getHyphenationFrequency()
   * @see #getBreakStrategy()
   */
  public void setHyphenationFrequency(@Layout.HyphenationFrequency int hyphenationFrequency) {
    mHyphenationFrequency = hyphenationFrequency;
    if (mLayout != null) {
      nullLayouts();
      requestLayout();
      invalidate();
    }
  }

  /**
   * Gets the current frequency of automatic hyphenation to be used when determining word breaks.
   * @return the current frequency of automatic hyphenation to be used when determining word
   * breaks.
   *
   * @attr ref android.R.styleable#TextView_hyphenationFrequency
   * @see #setHyphenationFrequency(int)
   */
  @InspectableProperty(enumMapping = {
    @EnumEntry(name = "none", value = Layout.HYPHENATION_FREQUENCY_NONE),
    @EnumEntry(name = "normal", value = Layout.HYPHENATION_FREQUENCY_NORMAL),
    @EnumEntry(name = "full", value = Layout.HYPHENATION_FREQUENCY_FULL)
  })
  @Layout.HyphenationFrequency
  public int getHyphenationFrequency() {
    return mHyphenationFrequency;
  }

  /**
   * Sets the line-break style for text wrapping.
   *
   * <p>Line-break style specifies the line-break strategies that can be used
   * for text wrapping. The line-break style affects rule-based line breaking
   * by specifying the strictness of line-breaking rules.
   *
   * <p>The following are types of line-break styles:
   * <ul>
   *   <li>{@link LineBreakConfig#LINE_BREAK_STYLE_LOOSE}
   *   <li>{@link LineBreakConfig#LINE_BREAK_STYLE_NORMAL}
   *   <li>{@link LineBreakConfig#LINE_BREAK_STYLE_STRICT}
   * </ul>
   *
   * <p>The default line-break style is
   * {@link LineBreakConfig#LINE_BREAK_STYLE_NONE}, which specifies that no
   * line-breaking rules are used.
   *
   * <p>See the
   * <a href="https://www.w3.org/TR/css-text-3/#line-break-property" class="external">
   * line-break property</a> for more information.
   *
   * @param lineBreakStyle The line-break style for the text.
   */
  public void setLineBreakStyle(@LineBreakConfig.LineBreakStyle int lineBreakStyle) {
    if (mLineBreakStyle != lineBreakStyle) {
      mLineBreakStyle = lineBreakStyle;
      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Sets the line-break word style for text wrapping.
   *
   * <p>The line-break word style affects dictionary-based line breaking by
   * providing phrase-based line-breaking opportunities. Use
   * {@link LineBreakConfig#LINE_BREAK_WORD_STYLE_PHRASE} to specify
   * phrase-based line breaking.
   *
   * <p>The default line-break word style is
   * {@link LineBreakConfig#LINE_BREAK_WORD_STYLE_NONE}, which specifies that
   * no line-breaking word style is used.
   *
   * <p>See the
   * <a href="https://www.w3.org/TR/css-text-3/#word-break-property" class="external">
   * word-break property</a> for more information.
   *
   * @param lineBreakWordStyle The line-break word style for the text.
   */
  public void setLineBreakWordStyle(@LineBreakConfig.LineBreakWordStyle int lineBreakWordStyle) {
    if (mLineBreakWordStyle != lineBreakWordStyle) {
      mLineBreakWordStyle = lineBreakWordStyle;
      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Gets the current line-break style for text wrapping.
   *
   * @return The line-break style to be used for text wrapping.
   */
  public @LineBreakConfig.LineBreakStyle int getLineBreakStyle() {
    return mLineBreakStyle;
  }

  /**
   * Gets the current line-break word style for text wrapping.
   *
   * @return The line-break word style to be used for text wrapping.
   */
  public @LineBreakConfig.LineBreakWordStyle int getLineBreakWordStyle() {
    return mLineBreakWordStyle;
  }

  /**
   * Gets the parameters for text layout precomputation, for use with {@link PrecomputedText}.
   *
   * @return a current {@link PrecomputedText.Params}
   * @see PrecomputedText
   */
  public @NonNull PrecomputedText.Params getTextMetricsParams() {
    return new PrecomputedText.Params(new TextPaint(mTextPaint),
                                      LineBreakConfig.getLineBreakConfig(mLineBreakStyle, mLineBreakWordStyle),
                                      getTextDirectionHeuristic(),
                                      mBreakStrategy, mHyphenationFrequency);
  }

  /**
   * Apply the text layout parameter.
   *
   * Update the TextView parameters to be compatible with {@link PrecomputedText.Params}.
   * @see PrecomputedText
   */
  public void setTextMetricsParams(@NonNull PrecomputedText.Params params) {
    mTextPaint.set(params.getTextPaint());
    mUserSetTextScaleX = true;
    mTextDir = params.getTextDirection();
    mBreakStrategy = params.getBreakStrategy();
    mHyphenationFrequency = params.getHyphenationFrequency();
    LineBreakConfig lineBreakConfig = params.getLineBreakConfig();
    mLineBreakStyle = LineBreakConfig.getResolvedLineBreakStyle(lineBreakConfig);
    mLineBreakWordStyle = LineBreakConfig.getResolvedLineBreakWordStyle(lineBreakConfig);
    if (mLayout != null) {
      nullLayouts();
      requestLayout();
      invalidate();
    }
  }

  /**
   * Set justification mode. The default value is {@link Layout#JUSTIFICATION_MODE_NONE}. If the
   * last line is too short for justification, the last line will be displayed with the
   * alignment set by {@link android.view.View#setTextAlignment}.
   *
   * @see #getJustificationMode()
   */
  @Layout.JustificationMode
  @android.view.RemotableViewMethod
  public void setJustificationMode(@Layout.JustificationMode int justificationMode) {
    mJustificationMode = justificationMode;
    if (mLayout != null) {
      nullLayouts();
      requestLayout();
      invalidate();
    }
  }

  /**
   * @return true if currently paragraph justification mode.
   *
   * @see #setJustificationMode(int)
   */
  @InspectableProperty(enumMapping = {
    @EnumEntry(name = "none", value = Layout.JUSTIFICATION_MODE_NONE),
    @EnumEntry(name = "inter_word", value = Layout.JUSTIFICATION_MODE_INTER_WORD)
  })
  public @Layout.JustificationMode int getJustificationMode() {
    return mJustificationMode;
  }

  /**
   * Sets font feature settings. The format is the same as the CSS
   * font-feature-settings attribute:
   * <a href="https://www.w3.org/TR/css-fonts-3/#font-feature-settings-prop">
   *     https://www.w3.org/TR/css-fonts-3/#font-feature-settings-prop</a>
   *
   * @param fontFeatureSettings font feature settings represented as CSS compatible string
   *
   * @see #getFontFeatureSettings()
   * @see Paint#getFontFeatureSettings() Paint.getFontFeatureSettings()
   *
   * @attr ref android.R.styleable#TextView_fontFeatureSettings
   */
  @android.view.RemotableViewMethod
  public void setFontFeatureSettings(@Nullable String fontFeatureSettings) {
    if (fontFeatureSettings != mTextPaint.getFontFeatureSettings()) {
      mTextPaint.setFontFeatureSettings(fontFeatureSettings);

      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }


  /**
   * Sets TrueType or OpenType font variation settings. The settings string is constructed from
   * multiple pairs of axis tag and style values. The axis tag must contain four ASCII characters
   * and must be wrapped with single quotes (U+0027) or double quotes (U+0022). Axis strings that
   * are longer or shorter than four characters, or contain characters outside of U+0020..U+007E
   * are invalid. If a specified axis name is not defined in the font, the settings will be
   * ignored.
   *
   * <p>
   * Examples,
   * <ul>
   * <li>Set font width to 150.
   * <pre>
   * <code>
   *   TextView textView = (TextView) findViewById(R.id.textView);
   *   textView.setFontVariationSettings("'wdth' 150");
   * </code>
   * </pre>
   * </li>
   *
   * <li>Set the font slant to 20 degrees and ask for italic style.
   * <pre>
   * <code>
   *   TextView textView = (TextView) findViewById(R.id.textView);
   *   textView.setFontVariationSettings("'slnt' 20, 'ital' 1");
   * </code>
   * </pre>
   * </p>
   * </li>
   * </ul>
   *
   * @param fontVariationSettings font variation settings. You can pass null or empty string as
   *                              no variation settings.
   * @return true if the given settings is effective to at least one font file underlying this
   *         TextView. This function also returns true for empty settings string. Otherwise
   *         returns false.
   *
   * @throws IllegalArgumentException If given string is not a valid font variation settings
   *                                  format.
   *
   * @see #getFontVariationSettings()
   * @see FontVariationAxis
   *
   * @attr ref android.R.styleable#TextView_fontVariationSettings
   */
  @android.view.RemotableViewMethod
  public boolean setFontVariationSettings(@Nullable String fontVariationSettings) {
    final String existingSettings = mTextPaint.getFontVariationSettings();
    if (fontVariationSettings == existingSettings
        || (fontVariationSettings != null
            && fontVariationSettings.equals(existingSettings))) {
      return true;
    }
    boolean effective = mTextPaint.setFontVariationSettings(fontVariationSettings);

    if (effective && mLayout != null) {
      nullLayouts();
      requestLayout();
      invalidate();
    }
    return effective;
  }

  /**
   * Sets the text color for all the states (normal, selected,
   * focused) to be this color.
   *
   * @param color A color value in the form 0xAARRGGBB.
   * Do not pass a resource ID. To get a color value from a resource ID, call
   * {@link androidx.core.content.ContextCompat#getColor(Context, int) getColor}.
   *
   * @see #setTextColor(ColorStateList)
   * @see #getTextColors()
   *
   * @attr ref android.R.styleable#TextView_textColor
   */
  @android.view.RemotableViewMethod
  public void setTextColor(@ColorInt int color) {
    mTextColor = ColorStateList.valueOf(color);
    updateTextColors();
  }

  /**
   * Sets the text color.
   *
   * @see #setTextColor(int)
   * @see #getTextColors()
   * @see #setHintTextColor(ColorStateList)
   * @see #setLinkTextColor(ColorStateList)
   *
   * @attr ref android.R.styleable#TextView_textColor
   */
  @android.view.RemotableViewMethod
  public void setTextColor(ColorStateList colors) {
    if (colors == null) {
      throw new NullPointerException();
    }

    mTextColor = colors;
    updateTextColors();
  }

  /**
   * Gets the text colors for the different states (normal, selected, focused) of the TextView.
   *
   * @see #setTextColor(ColorStateList)
   * @see #setTextColor(int)
   *
   * @attr ref android.R.styleable#TextView_textColor
   */
  @InspectableProperty(name = "textColor")
  public final ColorStateList getTextColors() {
    return mTextColor;
  }

  /**
   * Return the current color selected for normal text.
   *
   * @return Returns the current text color.
   */
  @ColorInt
  public final int getCurrentTextColor() {
    return mCurTextColor;
  }

  /**
   * Sets the color used to display the selection highlight.
   *
   * @attr ref android.R.styleable#TextView_textColorHighlight
   */
  @android.view.RemotableViewMethod
  public void setHighlightColor(@ColorInt int color) {
    if (mHighlightColor != color) {
      mHighlightColor = color;
      invalidate();
    }
  }

  /**
   * @return the color used to display the selection highlight
   *
   * @see #setHighlightColor(int)
   *
   * @attr ref android.R.styleable#TextView_textColorHighlight
   */
  @InspectableProperty(name = "textColorHighlight")
  @ColorInt
  public int getHighlightColor() {
    return mHighlightColor;
  }

  /**
   * Sets whether the soft input method will be made visible when this
   * TextView gets focused. The default is true.
   */
  @android.view.RemotableViewMethod
  public final void setShowSoftInputOnFocus(boolean show) {
    createEditorIfNeeded();
    mEditor.mShowSoftInputOnFocus = show;
  }

  /**
   * Returns whether the soft input method will be made visible when this
   * TextView gets focused. The default is true.
   */
  public final boolean getShowSoftInputOnFocus() {
    // When there is no Editor, return default true value
    return mEditor == null || mEditor.mShowSoftInputOnFocus;
  }

  /**
   * Gives the text a shadow of the specified blur radius and color, the specified
   * distance from its drawn position.
   * <p>
   * The text shadow produced does not interact with the properties on view
   * that are responsible for real time shadows,
   * {@link View#getElevation() elevation} and
   * {@link View#getTranslationZ() translationZ}.
   *
   * @see Paint#setShadowLayer(float, float, float, int)
   *
   * @attr ref android.R.styleable#TextView_shadowColor
   * @attr ref android.R.styleable#TextView_shadowDx
   * @attr ref android.R.styleable#TextView_shadowDy
   * @attr ref android.R.styleable#TextView_shadowRadius
   */
  public void setShadowLayer(float radius, float dx, float dy, int color) {
    mTextPaint.setShadowLayer(radius, dx, dy, color);

    mShadowRadius = radius;
    mShadowDx = dx;
    mShadowDy = dy;
    mShadowColor = color;

    // Will change text clip region
    if (mEditor != null) {
      mEditor.invalidateTextDisplayList();
      mEditor.invalidateHandlesAndActionMode();
    }
    invalidate();
  }

  /**
   * Gets the radius of the shadow layer.
   *
   * @return the radius of the shadow layer. If 0, the shadow layer is not visible
   *
   * @see #setShadowLayer(float, float, float, int)
   *
   * @attr ref android.R.styleable#TextView_shadowRadius
   */
  @InspectableProperty
  public float getShadowRadius() {
    return mShadowRadius;
  }

  /**
   * @return the horizontal offset of the shadow layer
   *
   * @see #setShadowLayer(float, float, float, int)
   *
   * @attr ref android.R.styleable#TextView_shadowDx
   */
  @InspectableProperty
  public float getShadowDx() {
    return mShadowDx;
  }

  /**
   * Gets the vertical offset of the shadow layer.
   * @return The vertical offset of the shadow layer.
   *
   * @see #setShadowLayer(float, float, float, int)
   *
   * @attr ref android.R.styleable#TextView_shadowDy
   */
  @InspectableProperty
  public float getShadowDy() {
    return mShadowDy;
  }

  /**
   * Gets the color of the shadow layer.
   * @return the color of the shadow layer
   *
   * @see #setShadowLayer(float, float, float, int)
   *
   * @attr ref android.R.styleable#TextView_shadowColor
   */
  @InspectableProperty
  @ColorInt
  public int getShadowColor() {
    return mShadowColor;
  }

  /**
   * Gets the {@link TextPaint} used for the text.
   * Use this only to consult the Paint's properties and not to change them.
   * @return The base paint used for the text.
   */
  public TextPaint getPaint() {
    return mTextPaint;
  }

  /**
   * Sets the autolink mask of the text.  See {@link
   * android.text.util.Linkify#ALL Linkify.ALL} and peers for
   * possible values.
   *
   * <p class="note"><b>Note:</b>
   * {@link android.text.util.Linkify#MAP_ADDRESSES Linkify.MAP_ADDRESSES}
   * is deprecated and should be avoided; see its documentation.
   *
   * @attr ref android.R.styleable#TextView_autoLink
   */
  @android.view.RemotableViewMethod
  public final void setAutoLinkMask(int mask) {
    mAutoLinkMask = mask;
  }

  /**
   * Sets whether the movement method will automatically be set to
   * {@link LinkMovementMethod} if {@link #setAutoLinkMask} has been
   * set to nonzero and links are detected in {@link #setText}.
   * The default is true.
   *
   * @attr ref android.R.styleable#TextView_linksClickable
   */
  @android.view.RemotableViewMethod
  public final void setLinksClickable(boolean whether) {
    mLinksClickable = whether;
  }

  /**
   * Returns whether the movement method will automatically be set to
   * {@link LinkMovementMethod} if {@link #setAutoLinkMask} has been
   * set to nonzero and links are detected in {@link #setText}.
   * The default is true.
   *
   * @attr ref android.R.styleable#TextView_linksClickable
   */
  @InspectableProperty
  public final boolean getLinksClickable() {
    return mLinksClickable;
  }

  /**
   * Returns the list of {@link android.text.style.URLSpan URLSpans} attached to the text
   * (by {@link Linkify} or otherwise) if any.  You can call
   * {@link URLSpan#getURL} on them to find where they link to
   * or use {@link Spanned#getSpanStart} and {@link Spanned#getSpanEnd}
   * to find the region of the text they are attached to.
   */
  public URLSpan[] getUrls() {
    if (mText instanceof Spanned) {
      return ((Spanned) mText).getSpans(0, mText.length(), URLSpan.class);
    } else {
      return new URLSpan[0];
    }
  }

  /**
   * Sets the color of the hint text for all the states (disabled, focussed, selected...) of this
   * TextView.
   *
   * @see #setHintTextColor(ColorStateList)
   * @see #getHintTextColors()
   * @see #setTextColor(int)
   *
   * @attr ref android.R.styleable#TextView_textColorHint
   */
  @android.view.RemotableViewMethod
  public final void setHintTextColor(@ColorInt int color) {
    mHintTextColor = ColorStateList.valueOf(color);
    updateTextColors();
  }

  /**
   * Sets the color of the hint text.
   *
   * @see #getHintTextColors()
   * @see #setHintTextColor(int)
   * @see #setTextColor(ColorStateList)
   * @see #setLinkTextColor(ColorStateList)
   *
   * @attr ref android.R.styleable#TextView_textColorHint
   */
  public final void setHintTextColor(ColorStateList colors) {
    mHintTextColor = colors;
    updateTextColors();
  }

  /**
   * @return the color of the hint text, for the different states of this TextView.
   *
   * @see #setHintTextColor(ColorStateList)
   * @see #setHintTextColor(int)
   * @see #setTextColor(ColorStateList)
   * @see #setLinkTextColor(ColorStateList)
   *
   * @attr ref android.R.styleable#TextView_textColorHint
   */
  @InspectableProperty(name = "textColorHint")
  public final ColorStateList getHintTextColors() {
    return mHintTextColor;
  }

  /**
   * <p>Return the current color selected to paint the hint text.</p>
   *
   * @return Returns the current hint text color.
   */
  @ColorInt
  public final int getCurrentHintTextColor() {
    return mHintTextColor != null ? mCurHintTextColor : mCurTextColor;
  }

  /**
   * Sets the color of links in the text.
   *
   * @see #setLinkTextColor(ColorStateList)
   * @see #getLinkTextColors()
   *
   * @attr ref android.R.styleable#TextView_textColorLink
   */
  @android.view.RemotableViewMethod
  public final void setLinkTextColor(@ColorInt int color) {
    mLinkTextColor = ColorStateList.valueOf(color);
    updateTextColors();
  }

  /**
   * Sets the color of links in the text.
   *
   * @see #setLinkTextColor(int)
   * @see #getLinkTextColors()
   * @see #setTextColor(ColorStateList)
   * @see #setHintTextColor(ColorStateList)
   *
   * @attr ref android.R.styleable#TextView_textColorLink
   */
  public final void setLinkTextColor(ColorStateList colors) {
    mLinkTextColor = colors;
    updateTextColors();
  }

  /**
   * @return the list of colors used to paint the links in the text, for the different states of
   * this TextView
   *
   * @see #setLinkTextColor(ColorStateList)
   * @see #setLinkTextColor(int)
   *
   * @attr ref android.R.styleable#TextView_textColorLink
   */
  @InspectableProperty(name = "textColorLink")
  public final ColorStateList getLinkTextColors() {
    return mLinkTextColor;
  }

  /**
   * Sets the horizontal alignment of the text and the
   * vertical gravity that will be used when there is extra space
   * in the TextView beyond what is required for the text itself.
   *
   * @see android.view.Gravity
   * @attr ref android.R.styleable#TextView_gravity
   */
  @android.view.RemotableViewMethod
  public void setGravity(int gravity) {
    if ((gravity & Gravity.RELATIVE_HORIZONTAL_GRAVITY_MASK) == 0) {
      gravity |= Gravity.START;
    }
    if ((gravity & Gravity.VERTICAL_GRAVITY_MASK) == 0) {
      gravity |= Gravity.TOP;
    }

    boolean newLayout = false;

    if ((gravity & Gravity.RELATIVE_HORIZONTAL_GRAVITY_MASK)
        != (mGravity & Gravity.RELATIVE_HORIZONTAL_GRAVITY_MASK)) {
      newLayout = true;
    }

    if (gravity != mGravity) {
      invalidate();
    }

    mGravity = gravity;

    if (mLayout != null && newLayout) {
      // XXX this is heavy-handed because no actual content changes.
      int want = mLayout.getWidth();
      int hintWant = mHintLayout == null ? 0 : mHintLayout.getWidth();

      makeNewLayout(want, hintWant, UNKNOWN_BORING, UNKNOWN_BORING,
                    mRight - mLeft - getCompoundPaddingLeft() - getCompoundPaddingRight(), true);
    }
  }

  /**
   * Returns the horizontal and vertical alignment of this TextView.
   *
   * @see android.view.Gravity
   * @attr ref android.R.styleable#TextView_gravity
   */
  @InspectableProperty(valueType = InspectableProperty.ValueType.GRAVITY)
  public int getGravity() {
    return mGravity;
  }

  /**
   * Gets the flags on the Paint being used to display the text.
   * @return The flags on the Paint being used to display the text.
   * @see Paint#getFlags
   */
  public int getPaintFlags() {
    return mTextPaint.getFlags();
  }

  /**
   * Sets flags on the Paint being used to display the text and
   * reflows the text if they are different from the old flags.
   * @see Paint#setFlags
   */
  @android.view.RemotableViewMethod
  public void setPaintFlags(int flags) {
    if (mTextPaint.getFlags() != flags) {
      mTextPaint.setFlags(flags);

      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Sets whether the text should be allowed to be wider than the
   * View is.  If false, it will be wrapped to the width of the View.
   *
   * @attr ref android.R.styleable#TextView_scrollHorizontally
   */
  public void setHorizontallyScrolling(boolean whether) {
    if (mHorizontallyScrolling != whether) {
      mHorizontallyScrolling = whether;

      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Returns whether the text is allowed to be wider than the View.
   * If false, the text will be wrapped to the width of the View.
   *
   * @attr ref android.R.styleable#TextView_scrollHorizontally
   * @see #setHorizontallyScrolling(boolean)
   */
  @InspectableProperty(name = "scrollHorizontally")
  public final boolean isHorizontallyScrollable() {
    return mHorizontallyScrolling;
  }

  /**
   * Returns whether the text is allowed to be wider than the View.
   * If false, the text will be wrapped to the width of the View.
   *
   * @attr ref android.R.styleable#TextView_scrollHorizontally
   * @hide
   */
  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P)
  public boolean getHorizontallyScrolling() {
    return mHorizontallyScrolling;
  }

  /**
   * Sets the height of the TextView to be at least {@code minLines} tall.
   * <p>
   * This value is used for height calculation if LayoutParams does not force TextView to have an
   * exact height. Setting this value overrides other previous minimum height configurations such
   * as {@link #setMinHeight(int)} or {@link #setHeight(int)}. {@link #setSingleLine()} will set
   * this value to 1.
   *
   * @param minLines the minimum height of TextView in terms of number of lines
   *
   * @see #getMinLines()
   * @see #setLines(int)
   *
   * @attr ref android.R.styleable#TextView_minLines
   */
  @android.view.RemotableViewMethod
  public void setMinLines(int minLines) {
    mMinimum = minLines;
    mMinMode = LINES;

    requestLayout();
    invalidate();
  }

  /**
   * Returns the minimum height of TextView in terms of number of lines or -1 if the minimum
   * height was set using {@link #setMinHeight(int)} or {@link #setHeight(int)}.
   *
   * @return the minimum height of TextView in terms of number of lines or -1 if the minimum
   *         height is not defined in lines
   *
   * @see #setMinLines(int)
   * @see #setLines(int)
   *
   * @attr ref android.R.styleable#TextView_minLines
   */
  @InspectableProperty
  public int getMinLines() {
    return mMinMode == LINES ? mMinimum : -1;
  }

  /**
   * Sets the height of the TextView to be at least {@code minPixels} tall.
   * <p>
   * This value is used for height calculation if LayoutParams does not force TextView to have an
   * exact height. Setting this value overrides previous minimum height configurations such as
   * {@link #setMinLines(int)} or {@link #setLines(int)}.
   * <p>
   * The value given here is different than {@link #setMinimumHeight(int)}. Between
   * {@code minHeight} and the value set in {@link #setMinimumHeight(int)}, the greater one is
   * used to decide the final height.
   *
   * @param minPixels the minimum height of TextView in terms of pixels
   *
   * @see #getMinHeight()
   * @see #setHeight(int)
   *
   * @attr ref android.R.styleable#TextView_minHeight
   */
  @android.view.RemotableViewMethod
  public void setMinHeight(int minPixels) {
    mMinimum = minPixels;
    mMinMode = PIXELS;

    requestLayout();
    invalidate();
  }

  /**
   * Returns the minimum height of TextView in terms of pixels or -1 if the minimum height was
   * set using {@link #setMinLines(int)} or {@link #setLines(int)}.
   *
   * @return the minimum height of TextView in terms of pixels or -1 if the minimum height is not
   *         defined in pixels
   *
   * @see #setMinHeight(int)
   * @see #setHeight(int)
   *
   * @attr ref android.R.styleable#TextView_minHeight
   */
  public int getMinHeight() {
    return mMinMode == PIXELS ? mMinimum : -1;
  }

  /**
   * Sets the height of the TextView to be at most {@code maxLines} tall.
   * <p>
   * This value is used for height calculation if LayoutParams does not force TextView to have an
   * exact height. Setting this value overrides previous maximum height configurations such as
   * {@link #setMaxHeight(int)} or {@link #setLines(int)}.
   *
   * @param maxLines the maximum height of TextView in terms of number of lines
   *
   * @see #getMaxLines()
   * @see #setLines(int)
   *
   * @attr ref android.R.styleable#TextView_maxLines
   */
  @android.view.RemotableViewMethod
  public void setMaxLines(int maxLines) {
    mMaximum = maxLines;
    mMaxMode = LINES;

    requestLayout();
    invalidate();
  }

  /**
   * Returns the maximum height of TextView in terms of number of lines or -1 if the
   * maximum height was set using {@link #setMaxHeight(int)} or {@link #setHeight(int)}.
   *
   * @return the maximum height of TextView in terms of number of lines. -1 if the maximum height
   *         is not defined in lines.
   *
   * @see #setMaxLines(int)
   * @see #setLines(int)
   *
   * @attr ref android.R.styleable#TextView_maxLines
   */
  @InspectableProperty
  public int getMaxLines() {
    return mMaxMode == LINES ? mMaximum : -1;
  }

  /**
   * Sets the height of the TextView to be at most {@code maxPixels} tall.
   * <p>
   * This value is used for height calculation if LayoutParams does not force TextView to have an
   * exact height. Setting this value overrides previous maximum height configurations such as
   * {@link #setMaxLines(int)} or {@link #setLines(int)}.
   *
   * @param maxPixels the maximum height of TextView in terms of pixels
   *
   * @see #getMaxHeight()
   * @see #setHeight(int)
   *
   * @attr ref android.R.styleable#TextView_maxHeight
   */
  @android.view.RemotableViewMethod
  public void setMaxHeight(int maxPixels) {
    mMaximum = maxPixels;
    mMaxMode = PIXELS;

    requestLayout();
    invalidate();
  }

  /**
   * Returns the maximum height of TextView in terms of pixels or -1 if the maximum height was
   * set using {@link #setMaxLines(int)} or {@link #setLines(int)}.
   *
   * @return the maximum height of TextView in terms of pixels or -1 if the maximum height
   *         is not defined in pixels
   *
   * @see #setMaxHeight(int)
   * @see #setHeight(int)
   *
   * @attr ref android.R.styleable#TextView_maxHeight
   */
  @InspectableProperty
  public int getMaxHeight() {
    return mMaxMode == PIXELS ? mMaximum : -1;
  }

  /**
   * Sets the height of the TextView to be exactly {@code lines} tall.
   * <p>
   * This value is used for height calculation if LayoutParams does not force TextView to have an
   * exact height. Setting this value overrides previous minimum/maximum height configurations
   * such as {@link #setMinLines(int)} or {@link #setMaxLines(int)}. {@link #setSingleLine()} will
   * set this value to 1.
   *
   * @param lines the exact height of the TextView in terms of lines
   *
   * @see #setHeight(int)
   *
   * @attr ref android.R.styleable#TextView_lines
   */
  @android.view.RemotableViewMethod
  public void setLines(int lines) {
    mMaximum = mMinimum = lines;
    mMaxMode = mMinMode = LINES;

    requestLayout();
    invalidate();
  }

  /**
   * Sets the height of the TextView to be exactly <code>pixels</code> tall.
   * <p>
   * This value is used for height calculation if LayoutParams does not force TextView to have an
   * exact height. Setting this value overrides previous minimum/maximum height configurations
   * such as {@link #setMinHeight(int)} or {@link #setMaxHeight(int)}.
   *
   * @param pixels the exact height of the TextView in terms of pixels
   *
   * @see #setLines(int)
   *
   * @attr ref android.R.styleable#TextView_height
   */
  @android.view.RemotableViewMethod
  public void setHeight(int pixels) {
    mMaximum = mMinimum = pixels;
    mMaxMode = mMinMode = PIXELS;

    requestLayout();
    invalidate();
  }

  /**
   * Sets the width of the TextView to be at least {@code minEms} wide.
   * <p>
   * This value is used for width calculation if LayoutParams does not force TextView to have an
   * exact width. Setting this value overrides previous minimum width configurations such as
   * {@link #setMinWidth(int)} or {@link #setWidth(int)}.
   *
   * @param minEms the minimum width of TextView in terms of ems
   *
   * @see #getMinEms()
   * @see #setEms(int)
   *
   * @attr ref android.R.styleable#TextView_minEms
   */
  @android.view.RemotableViewMethod
  public void setMinEms(int minEms) {
    mMinWidth = minEms;
    mMinWidthMode = EMS;

    requestLayout();
    invalidate();
  }

  /**
   * Returns the minimum width of TextView in terms of ems or -1 if the minimum width was set
   * using {@link #setMinWidth(int)} or {@link #setWidth(int)}.
   *
   * @return the minimum width of TextView in terms of ems. -1 if the minimum width is not
   *         defined in ems
   *
   * @see #setMinEms(int)
   * @see #setEms(int)
   *
   * @attr ref android.R.styleable#TextView_minEms
   */
  @InspectableProperty
  public int getMinEms() {
    return mMinWidthMode == EMS ? mMinWidth : -1;
  }

  /**
   * Sets the width of the TextView to be at least {@code minPixels} wide.
   * <p>
   * This value is used for width calculation if LayoutParams does not force TextView to have an
   * exact width. Setting this value overrides previous minimum width configurations such as
   * {@link #setMinEms(int)} or {@link #setEms(int)}.
   * <p>
   * The value given here is different than {@link #setMinimumWidth(int)}. Between
   * {@code minWidth} and the value set in {@link #setMinimumWidth(int)}, the greater one is used
   * to decide the final width.
   *
   * @param minPixels the minimum width of TextView in terms of pixels
   *
   * @see #getMinWidth()
   * @see #setWidth(int)
   *
   * @attr ref android.R.styleable#TextView_minWidth
   */
  @android.view.RemotableViewMethod
  public void setMinWidth(int minPixels) {
    mMinWidth = minPixels;
    mMinWidthMode = PIXELS;

    requestLayout();
    invalidate();
  }

  /**
   * Returns the minimum width of TextView in terms of pixels or -1 if the minimum width was set
   * using {@link #setMinEms(int)} or {@link #setEms(int)}.
   *
   * @return the minimum width of TextView in terms of pixels or -1 if the minimum width is not
   *         defined in pixels
   *
   * @see #setMinWidth(int)
   * @see #setWidth(int)
   *
   * @attr ref android.R.styleable#TextView_minWidth
   */
  @InspectableProperty
  public int getMinWidth() {
    return mMinWidthMode == PIXELS ? mMinWidth : -1;
  }

  /**
   * Sets the width of the TextView to be at most {@code maxEms} wide.
   * <p>
   * This value is used for width calculation if LayoutParams does not force TextView to have an
   * exact width. Setting this value overrides previous maximum width configurations such as
   * {@link #setMaxWidth(int)} or {@link #setWidth(int)}.
   *
   * @param maxEms the maximum width of TextView in terms of ems
   *
   * @see #getMaxEms()
   * @see #setEms(int)
   *
   * @attr ref android.R.styleable#TextView_maxEms
   */
  @android.view.RemotableViewMethod
  public void setMaxEms(int maxEms) {
    mMaxWidth = maxEms;
    mMaxWidthMode = EMS;

    requestLayout();
    invalidate();
  }

  /**
   * Returns the maximum width of TextView in terms of ems or -1 if the maximum width was set
   * using {@link #setMaxWidth(int)} or {@link #setWidth(int)}.
   *
   * @return the maximum width of TextView in terms of ems or -1 if the maximum width is not
   *         defined in ems
   *
   * @see #setMaxEms(int)
   * @see #setEms(int)
   *
   * @attr ref android.R.styleable#TextView_maxEms
   */
  @InspectableProperty
  public int getMaxEms() {
    return mMaxWidthMode == EMS ? mMaxWidth : -1;
  }

  /**
   * Sets the width of the TextView to be at most {@code maxPixels} wide.
   * <p>
   * This value is used for width calculation if LayoutParams does not force TextView to have an
   * exact width. Setting this value overrides previous maximum width configurations such as
   * {@link #setMaxEms(int)} or {@link #setEms(int)}.
   *
   * @param maxPixels the maximum width of TextView in terms of pixels
   *
   * @see #getMaxWidth()
   * @see #setWidth(int)
   *
   * @attr ref android.R.styleable#TextView_maxWidth
   */
  @android.view.RemotableViewMethod
  public void setMaxWidth(int maxPixels) {
    mMaxWidth = maxPixels;
    mMaxWidthMode = PIXELS;

    requestLayout();
    invalidate();
  }

  /**
   * Returns the maximum width of TextView in terms of pixels or -1 if the maximum width was set
   * using {@link #setMaxEms(int)} or {@link #setEms(int)}.
   *
   * @return the maximum width of TextView in terms of pixels. -1 if the maximum width is not
   *         defined in pixels
   *
   * @see #setMaxWidth(int)
   * @see #setWidth(int)
   *
   * @attr ref android.R.styleable#TextView_maxWidth
   */
  @InspectableProperty
  public int getMaxWidth() {
    return mMaxWidthMode == PIXELS ? mMaxWidth : -1;
  }

  /**
   * Sets the width of the TextView to be exactly {@code ems} wide.
   *
   * This value is used for width calculation if LayoutParams does not force TextView to have an
   * exact width. Setting this value overrides previous minimum/maximum configurations such as
   * {@link #setMinEms(int)} or {@link #setMaxEms(int)}.
   *
   * @param ems the exact width of the TextView in terms of ems
   *
   * @see #setWidth(int)
   *
   * @attr ref android.R.styleable#TextView_ems
   */
  @android.view.RemotableViewMethod
  public void setEms(int ems) {
    mMaxWidth = mMinWidth = ems;
    mMaxWidthMode = mMinWidthMode = EMS;

    requestLayout();
    invalidate();
  }

  /**
   * Sets the width of the TextView to be exactly {@code pixels} wide.
   * <p>
   * This value is used for width calculation if LayoutParams does not force TextView to have an
   * exact width. Setting this value overrides previous minimum/maximum width configurations
   * such as {@link #setMinWidth(int)} or {@link #setMaxWidth(int)}.
   *
   * @param pixels the exact width of the TextView in terms of pixels
   *
   * @see #setEms(int)
   *
   * @attr ref android.R.styleable#TextView_width
   */
  @android.view.RemotableViewMethod
  public void setWidth(int pixels) {
    mMaxWidth = mMinWidth = pixels;
    mMaxWidthMode = mMinWidthMode = PIXELS;

    requestLayout();
    invalidate();
  }

  /**
   * Sets line spacing for this TextView.  Each line other than the last line will have its height
   * multiplied by {@code mult} and have {@code add} added to it.
   *
   * @param add The value in pixels that should be added to each line other than the last line.
   *            This will be applied after the multiplier
   * @param mult The value by which each line height other than the last line will be multiplied
   *             by
   *
   * @attr ref android.R.styleable#TextView_lineSpacingExtra
   * @attr ref android.R.styleable#TextView_lineSpacingMultiplier
   */
  public void setLineSpacing(float add, float mult) {
    if (mSpacingAdd != add || mSpacingMult != mult) {
      mSpacingAdd = add;
      mSpacingMult = mult;

      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Gets the line spacing multiplier
   *
   * @return the value by which each line's height is multiplied to get its actual height.
   *
   * @see #setLineSpacing(float, float)
   * @see #getLineSpacingExtra()
   *
   * @attr ref android.R.styleable#TextView_lineSpacingMultiplier
   */
  @InspectableProperty
  public float getLineSpacingMultiplier() {
    return mSpacingMult;
  }

  /**
   * Gets the line spacing extra space
   *
   * @return the extra space that is added to the height of each lines of this TextView.
   *
   * @see #setLineSpacing(float, float)
   * @see #getLineSpacingMultiplier()
   *
   * @attr ref android.R.styleable#TextView_lineSpacingExtra
   */
  @InspectableProperty
  public float getLineSpacingExtra() {
    return mSpacingAdd;
  }

  /**
   * Sets an explicit line height for this TextView. This is equivalent to the vertical distance
   * between subsequent baselines in the TextView.
   *
   * @param lineHeight the line height in pixels
   *
   * @see #setLineSpacing(float, float)
   * @see #getLineSpacingExtra()
   *
   * @attr ref android.R.styleable#TextView_lineHeight
   */
  @android.view.RemotableViewMethod
  public void setLineHeight(@Px @IntRange(from = 0) int lineHeight) {
    setLineHeightPx(lineHeight);
  }

  private void setLineHeightPx(@Px @FloatRange(from = 0) float lineHeight) {
    Preconditions.checkArgumentNonNegative(lineHeight,
                                           "Expecting non-negative lineHeight while the input is " + lineHeight);

    final int fontHeight = getPaint().getFontMetricsInt(null);
    // Make sure we don't setLineSpacing if it's not needed to avoid unnecessary redraw.
    // TODO(b/274974975): should this also check if lineSpacing needs to change?
    if (lineHeight != fontHeight) {
      // Set lineSpacingExtra by the difference of lineSpacing with lineHeight
      setLineSpacing(lineHeight - fontHeight, 1f);

      mLineHeightComplexDimen =
        TypedValue.createComplexDimension(lineHeight, TypedValue.COMPLEX_UNIT_PX);
    }
  }

  /**
   * Sets an explicit line height to a given unit and value for this TextView. This is equivalent
   * to the vertical distance between subsequent baselines in the TextView. See {@link
   * TypedValue} for the possible dimension units.
   *
   * @param unit The desired dimension unit. SP units are strongly recommended so that line height
   *             stays proportional to the text size when fonts are scaled up for accessibility.
   * @param lineHeight The desired line height in the given units.
   *
   * @see #setLineSpacing(float, float)
   * @see #getLineSpacingExtra()
   *
   * @attr ref android.R.styleable#TextView_lineHeight
   */
  @android.view.RemotableViewMethod
  public void setLineHeight(
    @TypedValue.ComplexDimensionUnit int unit,
    @FloatRange(from = 0) float lineHeight
  ) {
    var metrics = getDisplayMetricsOrSystem();
    // We can avoid the recalculation if we know non-linear font scaling isn't being used
    // (an optimization for the majority case).
    // We also don't try to do the recalculation unless both textSize and lineHeight are in SP.
    if (!FontScaleConverterFactory.isNonLinearFontScalingActive(
      getResources().getConfiguration().fontScale)
        || unit != TypedValue.COMPLEX_UNIT_SP
        || mTextSizeUnit != TypedValue.COMPLEX_UNIT_SP
    ) {
      setLineHeightPx(TypedValue.applyDimension(unit, lineHeight, metrics));

      // Do this last so it overwrites what setLineHeightPx() sets it to.
      mLineHeightComplexDimen = TypedValue.createComplexDimension(lineHeight, unit);
      return;
    }

    // Recalculate a proportional line height when non-linear font scaling is in effect.
    // Otherwise, a desired 2x line height at font scale 1.0 will not be 2x at font scale 2.0,
    // due to non-linear font scaling compressing higher SP sizes. See b/273326061 for details.
    // We know they are using SP units for both the text size and the line height
    // at this point, so determine the ratio between them. This is the *intended* line spacing
    // multiplier if font scale == 1.0. We can then determine what the pixel value for the line
    // height would be if we preserved proportions.
    var textSizePx = getTextSize();
    var textSizeSp = TypedValue.convertPixelsToDimension(
      TypedValue.COMPLEX_UNIT_SP,
      textSizePx,
      metrics
    );
    var ratio = lineHeight / textSizeSp;
    setLineHeightPx(textSizePx * ratio);

    // Do this last so it overwrites what setLineHeightPx() sets it to.
    mLineHeightComplexDimen = TypedValue.createComplexDimension(lineHeight, unit);
  }

  private void maybeRecalculateLineHeight() {
    if (mLineHeightComplexDimen == 0) {
      return;
    }
    int unit = TypedValue.getUnitFromComplexDimension(mLineHeightComplexDimen);
    if (unit != TypedValue.COMPLEX_UNIT_SP) {
      // The lineHeight was never supplied in SP, so we didn't do any fancy recalculations
      // in setLineHeight(). We don't need to recalculate.
      return;
    }

    setLineHeight(unit, TypedValue.complexToFloat(mLineHeightComplexDimen));
  }

  /**
   * Set Highlights
   *
   * @param highlights A highlight object. Call with null for reset.
   *
   * @see #getHighlights()
   * @see Highlights
   */
  public void setHighlights(@Nullable Highlights highlights) {
    mHighlights = highlights;
    mHighlightPathsBogus = true;
    invalidate();
  }

  /**
   * Returns highlights
   *
   * @return a highlight to be drawn. null if no highlight was set.
   *
   * @see #setHighlights(Highlights)
   * @see Highlights
   *
   */
  @Nullable
  public Highlights getHighlights() {
    return mHighlights;
  }

  /**
   * Sets the search result ranges with flatten range representation.
   *
   * Ranges are represented of flattened inclusive start and exclusive end integers array. The
   * inclusive start offset of the {@code i}-th range is stored in {@code 2 * i}-th of the array.
   * The exclusive end offset of the {@code i}-th range is stored in {@code 2* i + 1}-th of the
   * array. For example, the two ranges: (1, 2) and (3, 4) are flattened into single int array
   * [1, 2, 3, 4].
   *
   * TextView will render the search result with the highlights with specified color in the theme.
   * If there is a focused search result, it is rendered with focused color. By calling this
   * method, the focused search index will be cleared.
   *
   * @attr ref android.R.styleable#TextView_searchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_searchResultHighlightColor
   * @attr ref android.R.styleable#TextView_focusedSearchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_focusedSearchResultHighlightColor
   *
   * @see #getSearchResultHighlights()
   * @see #setFocusedSearchResultIndex(int)
   * @see #getFocusedSearchResultIndex()
   * @see #setSearchResultHighlightColor(int)
   * @see #getSearchResultHighlightColor()
   * @see #setFocusedSearchResultHighlightColor(int)
   * @see #getFocusedSearchResultHighlightColor()
   *
   * @param ranges the flatten ranges of the search result. null for clear.
   */
  public void setSearchResultHighlights(@Nullable int... ranges) {
    if (ranges == null) {
      mSearchResultHighlights = null;
      mHighlightPathsBogus = true;
      return;
    }
    if (ranges.length % 2 == 1) {
      throw new IllegalArgumentException(
        "Flatten ranges must have even numbered elements");
    }
    for (int j = 0; j < ranges.length / 2; ++j) {
      int start = ranges[j * 2];
      int end = ranges[j * 2 + 1];
      if (start > end) {
        throw new IllegalArgumentException(
          "Reverse range found in the flatten range: " + start + ", " + end + ""
          + " at " + j + "-th range");
      }
    }
    mHighlightPathsBogus = true;
    mSearchResultHighlights = ranges;
    mFocusedSearchResultIndex = FOCUSED_SEARCH_RESULT_INDEX_NONE;
    invalidate();
  }

  /**
   * Gets the current search result ranges.
   *
   * @see #setSearchResultHighlights(int[])
   * @see #setFocusedSearchResultIndex(int)
   * @see #getFocusedSearchResultIndex()
   * @see #setSearchResultHighlightColor(int)
   * @see #getSearchResultHighlightColor()
   * @see #setFocusedSearchResultHighlightColor(int)
   * @see #getFocusedSearchResultHighlightColor()
   *
   * @return a flatten search result ranges. null if not available.
   */
  @Nullable
  public int[] getSearchResultHighlights() {
    return mSearchResultHighlights;
  }

  /**
   * A special index used for {@link #setFocusedSearchResultIndex(int)} and
   * {@link #getFocusedSearchResultIndex()} inidicating there is no focused search result.
   */
  public static final int FOCUSED_SEARCH_RESULT_INDEX_NONE = -1;

  /**
   * Sets the focused search result index.
   *
   * The focused search result is drawn in a focused color.
   * Calling {@link #FOCUSED_SEARCH_RESULT_INDEX_NONE} for clearing focused search result.
   *
   * This method must be called after setting search result ranges by
   * {@link #setSearchResultHighlights(int[])}.
   *
   * @attr ref android.R.styleable#TextView_searchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_searchResultHighlightColor
   * @attr ref android.R.styleable#TextView_focusedSearchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_focusedSearchResultHighlightColor
   *
   * @see #setSearchResultHighlights(int[])
   * @see #getSearchResultHighlights()
   * @see #setFocusedSearchResultIndex(int)
   * @see #getFocusedSearchResultIndex()
   * @see #setSearchResultHighlightColor(int)
   * @see #getSearchResultHighlightColor()
   * @see #setFocusedSearchResultHighlightColor(int)
   * @see #getFocusedSearchResultHighlightColor()
   *
   * @param index a focused search index or {@link #FOCUSED_SEARCH_RESULT_INDEX_NONE}
   */
  public void setFocusedSearchResultIndex(int index) {
    if (mSearchResultHighlights == null) {
      throw new IllegalArgumentException("Search result range must be set beforehand.");
    }
    if (index < -1 || index >= mSearchResultHighlights.length / 2) {
      throw new IllegalArgumentException("Focused index(" + index + ") must be larger than "
                                         + "-1 and less than range count(" + (mSearchResultHighlights.length / 2) + ")");
    }
    mFocusedSearchResultIndex = index;
    mHighlightPathsBogus = true;
    invalidate();
  }

  /**
   * Gets the focused search result index.
   *
   * @attr ref android.R.styleable#TextView_searchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_searchResultHighlightColor
   * @attr ref android.R.styleable#TextView_focusedSearchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_focusedSearchResultHighlightColor
   *
   * @see #setSearchResultHighlights(int[])
   * @see #getSearchResultHighlights()
   * @see #setFocusedSearchResultIndex(int)
   * @see #getFocusedSearchResultIndex()
   * @see #setSearchResultHighlightColor(int)
   * @see #getSearchResultHighlightColor()
   * @see #setFocusedSearchResultHighlightColor(int)
   * @see #getFocusedSearchResultHighlightColor()

   * @return a focused search index or {@link #FOCUSED_SEARCH_RESULT_INDEX_NONE}
   */
  public int getFocusedSearchResultIndex() {
    return mFocusedSearchResultIndex;
  }

  /**
   * Sets the search result highlight color.
   *
   * @attr ref android.R.styleable#TextView_searchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_searchResultHighlightColor
   * @attr ref android.R.styleable#TextView_focusedSearchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_focusedSearchResultHighlightColor
   *
   * @see #setSearchResultHighlights(int[])
   * @see #getSearchResultHighlights()
   * @see #setFocusedSearchResultIndex(int)
   * @see #getFocusedSearchResultIndex()
   * @see #setSearchResultHighlightColor(int)
   * @see #getSearchResultHighlightColor()
   * @see #setFocusedSearchResultHighlightColor(int)
   * @see #getFocusedSearchResultHighlightColor()

   * @param color a search result highlight color.
   */
  public void setSearchResultHighlightColor(@ColorInt int color) {
    mSearchResultHighlightColor = color;
  }

  /**
   * Gets the search result highlight color.
   *
   * @attr ref android.R.styleable#TextView_searchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_searchResultHighlightColor
   * @attr ref android.R.styleable#TextView_focusedSearchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_focusedSearchResultHighlightColor
   *
   * @see #setSearchResultHighlights(int[])
   * @see #getSearchResultHighlights()
   * @see #setFocusedSearchResultIndex(int)
   * @see #getFocusedSearchResultIndex()
   * @see #setSearchResultHighlightColor(int)
   * @see #getSearchResultHighlightColor()
   * @see #setFocusedSearchResultHighlightColor(int)
   * @see #getFocusedSearchResultHighlightColor()

   * @return a search result highlight color.
   */
  @ColorInt
  public int getSearchResultHighlightColor() {
    return mSearchResultHighlightColor;
  }

  /**
   * Sets focused search result highlight color.
   *
   * @attr ref android.R.styleable#TextView_searchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_searchResultHighlightColor
   * @attr ref android.R.styleable#TextView_focusedSearchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_focusedSearchResultHighlightColor
   *
   * @see #setSearchResultHighlights(int[])
   * @see #getSearchResultHighlights()
   * @see #setFocusedSearchResultIndex(int)
   * @see #getFocusedSearchResultIndex()
   * @see #setSearchResultHighlightColor(int)
   * @see #getSearchResultHighlightColor()
   * @see #setFocusedSearchResultHighlightColor(int)
   * @see #getFocusedSearchResultHighlightColor()

   * @param color a focused search result highlight color.
   */
  public void setFocusedSearchResultHighlightColor(@ColorInt int color) {
    mFocusedSearchResultHighlightColor = color;
  }

  /**
   * Gets focused search result highlight color.
   *
   * @attr ref android.R.styleable#TextView_searchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_searchResultHighlightColor
   * @attr ref android.R.styleable#TextView_focusedSearchResultHighlightColor
   * @attr ref android.R.styleable#TextAppearance_focusedSearchResultHighlightColor
   *
   * @see #setSearchResultHighlights(int[])
   * @see #getSearchResultHighlights()
   * @see #setFocusedSearchResultIndex(int)
   * @see #getFocusedSearchResultIndex()
   * @see #setSearchResultHighlightColor(int)
   * @see #getSearchResultHighlightColor()
   * @see #setFocusedSearchResultHighlightColor(int)
   * @see #getFocusedSearchResultHighlightColor()

   * @return a focused search result highlight color.
   */
  @ColorInt
  public int getFocusedSearchResultHighlightColor() {
    return mFocusedSearchResultHighlightColor;
  }

  /**
   * Highlights the text range (from inclusive start offset to exclusive end offset) to show what
   * will be selected by the ongoing select handwriting gesture. While the gesture preview
   * highlight is shown, the selection or cursor is hidden. If the text or selection is changed,
   * the gesture preview highlight will be cleared.
   */
  private void setSelectGesturePreviewHighlight(int start, int end) {
    // Selection preview highlight color is the same as selection highlight color.
    setGesturePreviewHighlight(start, end, mHighlightColor);
  }

  /**
   * Highlights the text range (from inclusive start offset to exclusive end offset) to show what
   * will be deleted by the ongoing delete handwriting gesture. While the gesture preview
   * highlight is shown, the selection or cursor is hidden. If the text or selection is changed,
   * the gesture preview highlight will be cleared.
   */
  private void setDeleteGesturePreviewHighlight(int start, int end) {
    // Deletion preview highlight color is 20% opacity of the default text color.
    int color = mTextColor.getDefaultColor();
    color = ColorUtils.setAlphaComponent(color, (int) (0.2f * Color.alpha(color)));
    setGesturePreviewHighlight(start, end, color);
  }

  private void setGesturePreviewHighlight(int start, int end, int color) {
    mGesturePreviewHighlightStart = start;
    mGesturePreviewHighlightEnd = end;
    if (mGesturePreviewHighlightPaint == null) {
      mGesturePreviewHighlightPaint = new Paint();
      mGesturePreviewHighlightPaint.setStyle(Paint.Style.FILL);
    }
    mGesturePreviewHighlightPaint.setColor(color);

    if (mEditor != null) {
      mEditor.hideCursorAndSpanControllers();
      mEditor.stopTextActionModeWithPreservingSelection();
    }

    mHighlightPathsBogus = true;
    invalidate();
  }

  private void clearGesturePreviewHighlight() {
    mGesturePreviewHighlightStart = -1;
    mGesturePreviewHighlightEnd = -1;
    mHighlightPathsBogus = true;
    invalidate();
  }

  boolean hasGesturePreviewHighlight() {
    return mGesturePreviewHighlightStart >= 0;
  }

  /**
   * Convenience method to append the specified text to the TextView's
   * display buffer, upgrading it to {@link android.widget.TextView.BufferType#EDITABLE}
   * if it was not already editable.
   *
   * @param text text to be appended to the already displayed text
   */
  public final void append(CharSequence text) {
    append(text, 0, text.length());
  }

  /**
   * Convenience method to append the specified text slice to the TextView's
   * display buffer, upgrading it to {@link android.widget.TextView.BufferType#EDITABLE}
   * if it was not already editable.
   *
   * @param text text to be appended to the already displayed text
   * @param start the index of the first character in the {@code text}
   * @param end the index of the character following the last character in the {@code text}
   *
   * @see Appendable#append(CharSequence, int, int)
   */
  public void append(CharSequence text, int start, int end) {
    if (!(mText instanceof Editable)) {
      setText(mText, BufferType.EDITABLE);
    }

    ((Editable) mText).append(text, start, end);

    if (mAutoLinkMask != 0) {
      boolean linksWereAdded = Linkify.addLinks(mSpannable, mAutoLinkMask);
      // Do not change the movement method for text that support text selection as it
      // would prevent an arbitrary cursor displacement.
      if (linksWereAdded && mLinksClickable && !textCanBeSelected()) {
        setMovementMethod(LinkMovementMethod.getInstance());
      }
    }
  }

  private void updateTextColors() {
    boolean inval = false;
    final int[] drawableState = getDrawableState();
    int color = mTextColor.getColorForState(drawableState, 0);
    if (color != mCurTextColor) {
      mCurTextColor = color;
      inval = true;
    }
    if (mLinkTextColor != null) {
      color = mLinkTextColor.getColorForState(drawableState, 0);
      if (color != mTextPaint.linkColor) {
        mTextPaint.linkColor = color;
        inval = true;
      }
    }
    if (mHintTextColor != null) {
      color = mHintTextColor.getColorForState(drawableState, 0);
      if (color != mCurHintTextColor) {
        mCurHintTextColor = color;
        if (mText.length() == 0) {
          inval = true;
        }
      }
    }
    if (inval) {
      // Text needs to be redrawn with the new color
      if (mEditor != null) mEditor.invalidateTextDisplayList();
      invalidate();
    }
  }

  @Override
  protected void drawableStateChanged() {
    super.drawableStateChanged();

    if (mTextColor != null && mTextColor.isStateful()
        || (mHintTextColor != null && mHintTextColor.isStateful())
        || (mLinkTextColor != null && mLinkTextColor.isStateful())) {
      updateTextColors();
    }

    if (mDrawables != null) {
      final int[] state = getDrawableState();
      for (Drawable dr : mDrawables.mShowing) {
        if (dr != null && dr.isStateful() && dr.setState(state)) {
          invalidateDrawable(dr);
        }
      }
    }
  }

  @Override
  public void drawableHotspotChanged(float x, float y) {
    super.drawableHotspotChanged(x, y);

    if (mDrawables != null) {
      for (Drawable dr : mDrawables.mShowing) {
        if (dr != null) {
          dr.setHotspot(x, y);
        }
      }
    }
  }

  @Override
  public Parcelable onSaveInstanceState() {
    Parcelable superState = super.onSaveInstanceState();

    // Save state if we are forced to
    final boolean freezesText = getFreezesText();
    boolean hasSelection = false;
    int start = -1;
    int end = -1;

    if (mText != null) {
      start = getSelectionStart();
      end = getSelectionEnd();
      if (start >= 0 || end >= 0) {
        // Or save state if there is a selection
        hasSelection = true;
      }
    }

    if (freezesText || hasSelection) {
      SavedState ss = new SavedState(superState);

      if (freezesText) {
        if (mText instanceof Spanned) {
          final Spannable sp = new SpannableStringBuilder(mText);

          if (mEditor != null) {
            removeMisspelledSpans(sp);
            sp.removeSpan(mEditor.mSuggestionRangeSpan);
          }

          ss.text = sp;
        } else {
          ss.text = mText.toString();
        }
      }

      if (hasSelection) {
        // XXX Should also save the current scroll position!
        ss.selStart = start;
        ss.selEnd = end;
      }

      if (isFocused() && start >= 0 && end >= 0) {
        ss.frozenWithFocus = true;
      }

      ss.error = getError();

      if (mEditor != null) {
        ss.editorState = mEditor.saveInstanceState();
      }
      return ss;
    }

    return superState;
  }

  void removeMisspelledSpans(Spannable spannable) {
    SuggestionSpan[] suggestionSpans = spannable.getSpans(0, spannable.length(),
                                                          SuggestionSpan.class);
    for (int i = 0; i < suggestionSpans.length; i++) {
      int flags = suggestionSpans[i].getFlags();
      if ((flags & SuggestionSpan.FLAG_EASY_CORRECT) != 0
          && (flags & SuggestionSpan.FLAG_MISSPELLED) != 0) {
        spannable.removeSpan(suggestionSpans[i]);
      }
    }
  }

  @Override
  public void onRestoreInstanceState(Parcelable state) {
    if (!(state instanceof SavedState)) {
      super.onRestoreInstanceState(state);
      return;
    }

    SavedState ss = (SavedState) state;
    super.onRestoreInstanceState(ss.getSuperState());

    // XXX restore buffer type too, as well as lots of other stuff
    if (ss.text != null) {
      setText(ss.text);
    }

    if (ss.selStart >= 0 && ss.selEnd >= 0) {
      if (mSpannable != null) {
        int len = mText.length();

        if (ss.selStart > len || ss.selEnd > len) {
          String restored = "";

          if (ss.text != null) {
            restored = "(restored) ";
          }

          Log.e(LOG_TAG, "Saved cursor position " + ss.selStart + "/" + ss.selEnd
                         + " out of range for " + restored + "text " + mText);
        } else {
          Selection.setSelection(mSpannable, ss.selStart, ss.selEnd);

          if (ss.frozenWithFocus) {
            createEditorIfNeeded();
            mEditor.mFrozenWithFocus = true;
          }
        }
      }
    }

    if (ss.error != null) {
      final CharSequence error = ss.error;
      // Display the error later, after the first layout pass
      post(new Runnable() {
        public void run() {
          if (mEditor == null || !mEditor.mErrorWasChanged) {
            setError(error);
          }
        }
      });
    }

    if (ss.editorState != null) {
      createEditorIfNeeded();
      mEditor.restoreInstanceState(ss.editorState);
    }
  }

  /**
   * Control whether this text view saves its entire text contents when
   * freezing to an icicle, in addition to dynamic state such as cursor
   * position.  By default this is false, not saving the text.  Set to true
   * if the text in the text view is not being saved somewhere else in
   * persistent storage (such as in a content provider) so that if the
   * view is later thawed the user will not lose their data. For
   * {@link android.widget.EditText} it is always enabled, regardless of
   * the value of the attribute.
   *
   * @param freezesText Controls whether a frozen icicle should include the
   * entire text data: true to include it, false to not.
   *
   * @attr ref android.R.styleable#TextView_freezesText
   */
  @android.view.RemotableViewMethod
  public void setFreezesText(boolean freezesText) {
    mFreezesText = freezesText;
  }

  /**
   * Return whether this text view is including its entire text contents
   * in frozen icicles. For {@link android.widget.EditText} it always returns true.
   *
   * @return Returns true if text is included, false if it isn't.
   *
   * @see #setFreezesText
   */
  @InspectableProperty
  public boolean getFreezesText() {
    return mFreezesText;
  }

  ///////////////////////////////////////////////////////////////////////////

  /**
   * Sets the Factory used to create new {@link Editable Editables}.
   *
   * @param factory {@link android.text.Editable.Factory Editable.Factory} to be used
   *
   * @see android.text.Editable.Factory
   * @see android.widget.TextView.BufferType#EDITABLE
   */
  public final void setEditableFactory(Editable.Factory factory) {
    mEditableFactory = factory;
    setText(mText);
  }

  /**
   * Sets the Factory used to create new {@link Spannable Spannables}.
   *
   * @param factory {@link android.text.Spannable.Factory Spannable.Factory} to be used
   *
   * @see android.text.Spannable.Factory
   * @see android.widget.TextView.BufferType#SPANNABLE
   */
  public final void setSpannableFactory(Spannable.Factory factory) {
    mSpannableFactory = factory;
    setText(mText);
  }

  /**
   * Sets the text to be displayed. TextView <em>does not</em> accept
   * HTML-like formatting, which you can do with text strings in XML resource files.
   * To style your strings, attach android.text.style.* objects to a
   * {@link android.text.SpannableString}, or see the
   * <a href="{@docRoot}guide/topics/resources/available-resources.html#stringresources">
   * Available Resource Types</a> documentation for an example of setting
   * formatted text in the XML resource file.
   * <p/>
   * When required, TextView will use {@link android.text.Spannable.Factory} to create final or
   * intermediate {@link Spannable Spannables}. Likewise it will use
   * {@link android.text.Editable.Factory} to create final or intermediate
   * {@link Editable Editables}.
   *
   * If the passed text is a {@link PrecomputedText} but the parameters used to create the
   * PrecomputedText mismatches with this TextView, IllegalArgumentException is thrown. To ensure
   * the parameters match, you can call {@link TextView#setTextMetricsParams} before calling this.
   *
   * @param text text to be displayed
   *
   * @attr ref android.R.styleable#TextView_text
   * @throws IllegalArgumentException if the passed text is a {@link PrecomputedText} but the
   *                                  parameters used to create the PrecomputedText mismatches
   *                                  with this TextView.
   */
  @android.view.RemotableViewMethod(asyncImpl = "setTextAsync")
  public final void setText(CharSequence text) {
    setText(text, mBufferType);
  }

  /**
   * RemotableViewMethod's asyncImpl of {@link #setText(CharSequence)}.
   * This should be called on a background thread, and returns a Runnable which is then must be
   * called on the main thread to complete the operation and set text.
   * @param text text to be displayed
   * @return Runnable that sets text; must be called on the main thread by the caller of this
   * method to complete the operation
   * @hide
   */
  @NonNull
  public Runnable setTextAsync(@Nullable CharSequence text) {
    return () -> setText(text);
  }

  /**
   * Sets the text to be displayed but retains the cursor position. Same as
   * {@link #setText(CharSequence)} except that the cursor position (if any) is retained in the
   * new text.
   * <p/>
   * When required, TextView will use {@link android.text.Spannable.Factory} to create final or
   * intermediate {@link Spannable Spannables}. Likewise it will use
   * {@link android.text.Editable.Factory} to create final or intermediate
   * {@link Editable Editables}.
   *
   * @param text text to be displayed
   *
   * @see #setText(CharSequence)
   */
  @android.view.RemotableViewMethod
  public final void setTextKeepState(CharSequence text) {
    setTextKeepState(text, mBufferType);
  }

  /**
   * Sets the text to be displayed and the {@link android.widget.TextView.BufferType}.
   * <p/>
   * When required, TextView will use {@link android.text.Spannable.Factory} to create final or
   * intermediate {@link Spannable Spannables}. Likewise it will use
   * {@link android.text.Editable.Factory} to create final or intermediate
   * {@link Editable Editables}.
   *
   * Subclasses overriding this method should ensure that the following post condition holds,
   * in order to guarantee the safety of the view's measurement and layout operations:
   * regardless of the input, after calling #setText both {@code mText} and {@code mTransformed}
   * will be different from {@code null}.
   *
   * @param text text to be displayed
   * @param type a {@link android.widget.TextView.BufferType} which defines whether the text is
   *              stored as a static text, styleable/spannable text, or editable text
   *
   * @see #setText(CharSequence)
   * @see android.widget.TextView.BufferType
   * @see #setSpannableFactory(Spannable.Factory)
   * @see #setEditableFactory(Editable.Factory)
   *
   * @attr ref android.R.styleable#TextView_text
   * @attr ref android.R.styleable#TextView_bufferType
   */
  public void setText(CharSequence text, BufferType type) {
    setText(text, type, true, 0);

    // drop any potential mCharWrappper leaks
    mCharWrapper = null;
  }

  @UnsupportedAppUsage
  private void setText(CharSequence text, BufferType type,
                       boolean notifyBefore, int oldlen) {
    if (mEditor != null) {
      mEditor.beforeSetText();
    }
    mTextSetFromXmlOrResourceId = false;
    if (text == null) {
      text = "";
    }

    // If suggestions are not enabled, remove the suggestion spans from the text
    if (!isSuggestionsEnabled()) {
      text = removeSuggestionSpans(text);
    }

    if (!mUserSetTextScaleX) mTextPaint.setTextScaleX(1.0f);

    if (text instanceof Spanned
        && ((Spanned) text).getSpanStart(TextUtils.TruncateAt.MARQUEE) >= 0) {
      if (ViewConfiguration.get(mContext).isFadingMarqueeEnabled()) {
        setHorizontalFadingEdgeEnabled(true);
        mMarqueeFadeMode = MARQUEE_FADE_NORMAL;
      } else {
        setHorizontalFadingEdgeEnabled(false);
        mMarqueeFadeMode = MARQUEE_FADE_SWITCH_SHOW_ELLIPSIS;
      }
      setEllipsize(TextUtils.TruncateAt.MARQUEE);
    }

    int n = mFilters.length;
    for (int i = 0; i < n; i++) {
      CharSequence out = mFilters[i].filter(text, 0, text.length(), EMPTY_SPANNED, 0, 0);
      if (out != null) {
        text = out;
      }
    }

    if (notifyBefore) {
      if (mText != null) {
        oldlen = mText.length();
        sendBeforeTextChanged(mText, 0, oldlen, text.length());
      } else {
        sendBeforeTextChanged("", 0, 0, text.length());
      }
    }

    boolean needEditableForNotification = false;

    if (mListeners != null && mListeners.size() != 0) {
      needEditableForNotification = true;
    }

    PrecomputedText precomputed =
      (text instanceof PrecomputedText) ? (PrecomputedText) text : null;
    if (type == BufferType.EDITABLE || getKeyListener() != null
        || needEditableForNotification) {
      createEditorIfNeeded();
      mEditor.forgetUndoRedo();
      mEditor.scheduleRestartInputForSetText();
      Editable t = mEditableFactory.newEditable(text);
      text = t;
      setFilters(t, mFilters);
    } else if (precomputed != null) {
      if (mTextDir == null) {
        mTextDir = getTextDirectionHeuristic();
      }
      final @PrecomputedText.Params.CheckResultUsableResult int checkResult =
        precomputed.getParams().checkResultUsable(getPaint(), mTextDir, mBreakStrategy,
                                                  mHyphenationFrequency, LineBreakConfig.getLineBreakConfig(
            mLineBreakStyle, mLineBreakWordStyle));
      switch (checkResult) {
        case PrecomputedText.Params.UNUSABLE:
          throw new IllegalArgumentException(
            "PrecomputedText's Parameters don't match the parameters of this TextView."
            + "Consider using setTextMetricsParams(precomputedText.getParams()) "
            + "to override the settings of this TextView: "
            + "PrecomputedText: " + precomputed.getParams()
            + "TextView: " + getTextMetricsParams());
        case PrecomputedText.Params.NEED_RECOMPUTE:
          precomputed = PrecomputedText.create(precomputed, getTextMetricsParams());
          break;
        case PrecomputedText.Params.USABLE:
          // pass through
      }
    } else if (type == BufferType.SPANNABLE || mMovement != null) {
      text = mSpannableFactory.newSpannable(text);
    } else if (!(text instanceof CharWrapper)) {
      text = TextUtils.stringOrSpannedString(text);
    }

    @AccessibilityUtils.A11yTextChangeType int a11yTextChangeType = AccessibilityUtils.NONE;
    if (AccessibilityManager.getInstance(mContext).isEnabled()) {
      a11yTextChangeType = AccessibilityUtils.textOrSpanChanged(text, mText);
    }

    if (mAutoLinkMask != 0) {
      Spannable s2;

      if (type == BufferType.EDITABLE || text instanceof Spannable) {
        s2 = (Spannable) text;
      } else {
        s2 = mSpannableFactory.newSpannable(text);
      }

      if (Linkify.addLinks(s2, mAutoLinkMask)) {
        text = s2;
        type = (type == BufferType.EDITABLE) ? BufferType.EDITABLE : BufferType.SPANNABLE;

        /*
         * We must go ahead and set the text before changing the
         * movement method, because setMovementMethod() may call
         * setText() again to try to upgrade the buffer type.
         */
        setTextInternal(text);
        if (a11yTextChangeType == AccessibilityUtils.NONE) {
          a11yTextChangeType = AccessibilityUtils.PARCELABLE_SPAN;
        }

        // Do not change the movement method for text that support text selection as it
        // would prevent an arbitrary cursor displacement.
        if (mLinksClickable && !textCanBeSelected()) {
          setMovementMethod(LinkMovementMethod.getInstance());
        }
      }
    }

    mBufferType = type;
    setTextInternal(text);

    if (mTransformation == null) {
      mTransformed = text;
    } else {
      mTransformed = mTransformation.getTransformation(text, this);
    }
    if (mTransformed == null) {
      // Should not happen if the transformation method follows the non-null postcondition.
      mTransformed = "";
    }

    final int textLength = text.length();
    final boolean isOffsetMapping = mTransformed instanceof OffsetMapping;

    if (text instanceof Spannable && (!mAllowTransformationLengthChange || isOffsetMapping)) {
      Spannable sp = (Spannable) text;

      // Remove any ChangeWatchers that might have come from other TextViews.
      final ChangeWatcher[] watchers = sp.getSpans(0, sp.length(), ChangeWatcher.class);
      final int count = watchers.length;
      for (int i = 0; i < count; i++) {
        sp.removeSpan(watchers[i]);
      }

      if (mChangeWatcher == null) mChangeWatcher = new ChangeWatcher();

      sp.setSpan(mChangeWatcher, 0, textLength, Spanned.SPAN_INCLUSIVE_INCLUSIVE
                                                | (CHANGE_WATCHER_PRIORITY << Spanned.SPAN_PRIORITY_SHIFT));

      if (mEditor != null) mEditor.addSpanWatchers(sp);

      if (mTransformation != null) {
        final int priority = isOffsetMapping ? OFFSET_MAPPING_SPAN_PRIORITY : 0;
        sp.setSpan(mTransformation, 0, textLength, Spanned.SPAN_INCLUSIVE_INCLUSIVE
                                                   | (priority << Spanned.SPAN_PRIORITY_SHIFT));
      }

      if (mMovement != null) {
        mMovement.initialize(this, (Spannable) text);

        /*
         * Initializing the movement method will have set the
         * selection, so reset mSelectionMoved to keep that from
         * interfering with the normal on-focus selection-setting.
         */
        if (mEditor != null) mEditor.mSelectionMoved = false;
      }
    }

    if (mLayout != null) {
      checkForRelayout();
    }

    sendOnTextChanged(text, 0, oldlen, textLength);
    onTextChanged(text, 0, oldlen, textLength);

    mHideHint = false;

    if (a11yTextChangeType == AccessibilityUtils.TEXT) {
      notifyViewAccessibilityStateChangedIfNeeded(
        AccessibilityEvent.CONTENT_CHANGE_TYPE_TEXT);
    } else if (a11yTextChangeType == AccessibilityUtils.PARCELABLE_SPAN) {
      notifyViewAccessibilityStateChangedIfNeeded(
        AccessibilityEvent.CONTENT_CHANGE_TYPE_UNDEFINED);
    }

    if (needEditableForNotification) {
      sendAfterTextChanged((Editable) text);
    } else {
      notifyListeningManagersAfterTextChanged();
    }

    if (mEditor != null) {
      // SelectionModifierCursorController depends on textCanBeSelected, which depends on text
      mEditor.prepareCursorControllers();

      mEditor.maybeFireScheduledRestartInputForSetText();
    }
  }

  /**
   * Sets the TextView to display the specified slice of the specified
   * char array. You must promise that you will not change the contents
   * of the array except for right before another call to setText(),
   * since the TextView has no way to know that the text
   * has changed and that it needs to invalidate and re-layout.
   *
   * @throws NullPointerException if text is null
   * @throws IndexOutOfBoundsException if start or start+len are not in 0 to text.length
   *
   * @param text char array to be displayed
   * @param start start index in the char array
   * @param len length of char count after {@code start}
   */
  public final void setText(@NonNull char[] text, int start, int len) {
    int oldlen = 0;

    if (start < 0 || len < 0 || start + len > text.length) {
      throw new IndexOutOfBoundsException(start + ", " + len);
    }

    /*
     * We must do the before-notification here ourselves because if
     * the old text is a CharWrapper we destroy it before calling
     * into the normal path.
     */
    if (mText != null) {
      oldlen = mText.length();
      sendBeforeTextChanged(mText, 0, oldlen, len);
    } else {
      sendBeforeTextChanged("", 0, 0, len);
    }

    if (mCharWrapper == null) {
      mCharWrapper = new CharWrapper(text, start, len);
    } else {
      mCharWrapper.set(text, start, len);
    }

    setText(mCharWrapper, mBufferType, false, oldlen);
  }

  /**
   * Sets the text to be displayed and the {@link android.widget.TextView.BufferType} but retains
   * the cursor position. Same as
   * {@link #setText(CharSequence, android.widget.TextView.BufferType)} except that the cursor
   * position (if any) is retained in the new text.
   * <p/>
   * When required, TextView will use {@link android.text.Spannable.Factory} to create final or
   * intermediate {@link Spannable Spannables}. Likewise it will use
   * {@link android.text.Editable.Factory} to create final or intermediate
   * {@link Editable Editables}.
   *
   * @param text text to be displayed
   * @param type a {@link android.widget.TextView.BufferType} which defines whether the text is
   *              stored as a static text, styleable/spannable text, or editable text
   *
   * @see #setText(CharSequence, android.widget.TextView.BufferType)
   */
  public final void setTextKeepState(CharSequence text, BufferType type) {
    int start = getSelectionStart();
    int end = getSelectionEnd();
    int len = text.length();

    setText(text, type);

    if (start >= 0 || end >= 0) {
      if (mSpannable != null) {
        Selection.setSelection(mSpannable,
                               Math.max(0, Math.min(start, len)),
                               Math.max(0, Math.min(end, len)));
      }
    }
  }

  /**
   * Sets the text to be displayed using a string resource identifier.
   *
   * @param resid the resource identifier of the string resource to be displayed
   *
   * @see #setText(CharSequence)
   *
   * @attr ref android.R.styleable#TextView_text
   */
  @android.view.RemotableViewMethod
  public final void setText(@StringRes int resid) {
    setText(getContext().getResources().getText(resid));
    mTextSetFromXmlOrResourceId = true;
    mTextId = resid;
  }

  /**
   * Sets the text to be displayed using a string resource identifier and the
   * {@link android.widget.TextView.BufferType}.
   * <p/>
   * When required, TextView will use {@link android.text.Spannable.Factory} to create final or
   * intermediate {@link Spannable Spannables}. Likewise it will use
   * {@link android.text.Editable.Factory} to create final or intermediate
   * {@link Editable Editables}.
   *
   * @param resid the resource identifier of the string resource to be displayed
   * @param type a {@link android.widget.TextView.BufferType} which defines whether the text is
   *              stored as a static text, styleable/spannable text, or editable text
   *
   * @see #setText(int)
   * @see #setText(CharSequence)
   * @see android.widget.TextView.BufferType
   * @see #setSpannableFactory(Spannable.Factory)
   * @see #setEditableFactory(Editable.Factory)
   *
   * @attr ref android.R.styleable#TextView_text
   * @attr ref android.R.styleable#TextView_bufferType
   */
  public final void setText(@StringRes int resid, BufferType type) {
    setText(getContext().getResources().getText(resid), type);
    mTextSetFromXmlOrResourceId = true;
    mTextId = resid;
  }

  /**
   * Sets the text to be displayed when the text of the TextView is empty.
   * Null means to use the normal empty text. The hint does not currently
   * participate in determining the size of the view.
   *
   * @attr ref android.R.styleable#TextView_hint
   */
  @android.view.RemotableViewMethod
  public final void setHint(CharSequence hint) {
    setHintInternal(hint);

    if (mEditor != null && isInputMethodTarget()) {
      mEditor.reportExtractedText();
    }
  }

  private void setHintInternal(CharSequence hint) {
    mHideHint = false;
    mHint = TextUtils.stringOrSpannedString(hint);

    if (mLayout != null) {
      checkForRelayout();
    }

    if (mText.length() == 0) {
      invalidate();
    }

    // Invalidate display list if hint is currently used
    if (mEditor != null && mText.length() == 0 && mHint != null) {
      mEditor.invalidateTextDisplayList();
    }
  }

  /**
   * Sets the text to be displayed when the text of the TextView is empty,
   * from a resource.
   *
   * @attr ref android.R.styleable#TextView_hint
   */
  @android.view.RemotableViewMethod
  public final void setHint(@StringRes int resid) {
    mHintId = resid;
    setHint(getContext().getResources().getText(resid));
  }

  /**
   * Returns the hint that is displayed when the text of the TextView
   * is empty.
   *
   * @attr ref android.R.styleable#TextView_hint
   */
  @InspectableProperty
  @ViewDebug.CapturedViewProperty
  public CharSequence getHint() {
    return mHint;
  }

  /**
   * Temporarily hides the hint text until the text is modified, or the hint text is modified, or
   * the view gains or loses focus.
   *
   * @hide
   */
  public void hideHint() {
    if (isShowingHint()) {
      mHideHint = true;
      invalidate();
    }
  }

  /**
   * Returns if the text is constrained to a single horizontally scrolling line ignoring new
   * line characters instead of letting it wrap onto multiple lines.
   *
   * @attr ref android.R.styleable#TextView_singleLine
   */
  @InspectableProperty
  public boolean isSingleLine() {
    return mSingleLine;
  }

  private static boolean isMultilineInputType(int type) {
    return (type & (EditorInfo.TYPE_MASK_CLASS | EditorInfo.TYPE_TEXT_FLAG_MULTI_LINE))
           == (EditorInfo.TYPE_CLASS_TEXT | EditorInfo.TYPE_TEXT_FLAG_MULTI_LINE);
  }

  /**
   * Removes the suggestion spans.
   */
  CharSequence removeSuggestionSpans(CharSequence text) {
    if (text instanceof Spanned) {
      Spannable spannable;
      if (text instanceof Spannable) {
        spannable = (Spannable) text;
      } else {
        spannable = mSpannableFactory.newSpannable(text);
      }

      SuggestionSpan[] spans = spannable.getSpans(0, text.length(), SuggestionSpan.class);
      if (spans.length == 0) {
        return text;
      } else {
        text = spannable;
      }

      for (int i = 0; i < spans.length; i++) {
        spannable.removeSpan(spans[i]);
      }
    }
    return text;
  }

  /**
   * Set the type of the content with a constant as defined for {@link EditorInfo#inputType}. This
   * will take care of changing the key listener, by calling {@link #setKeyListener(KeyListener)},
   * to match the given content type.  If the given content type is {@link EditorInfo#TYPE_NULL}
   * then a soft keyboard will not be displayed for this text view.
   *
   * Note that the maximum number of displayed lines (see {@link #setMaxLines(int)}) will be
   * modified if you change the {@link EditorInfo#TYPE_TEXT_FLAG_MULTI_LINE} flag of the input
   * type.
   *
   * @see #getInputType()
   * @see #setRawInputType(int)
   * @see android.text.InputType
   * @attr ref android.R.styleable#TextView_inputType
   */
  public void setInputType(int type) {
    final boolean wasPassword = isPasswordInputType(getInputType());
    final boolean wasVisiblePassword = isVisiblePasswordInputType(getInputType());
    setInputType(type, false);
    final boolean isPassword = isPasswordInputType(type);
    final boolean isVisiblePassword = isVisiblePasswordInputType(type);
    boolean forceUpdate = false;
    if (isPassword) {
      setTransformationMethod(PasswordTransformationMethod.getInstance());
      setTypefaceFromAttrs(null/* fontTypeface */, null /* fontFamily */, MONOSPACE,
                           Typeface.NORMAL, FontStyle.FONT_WEIGHT_UNSPECIFIED);
    } else if (isVisiblePassword) {
      if (mTransformation == PasswordTransformationMethod.getInstance()) {
        forceUpdate = true;
      }
      setTypefaceFromAttrs(null/* fontTypeface */, null /* fontFamily */, MONOSPACE,
                           Typeface.NORMAL, FontStyle.FONT_WEIGHT_UNSPECIFIED);
    } else if (wasPassword || wasVisiblePassword) {
      // not in password mode, clean up typeface and transformation
      setTypefaceFromAttrs(null/* fontTypeface */, null /* fontFamily */,
                           DEFAULT_TYPEFACE /* typeface index */, Typeface.NORMAL,
                           FontStyle.FONT_WEIGHT_UNSPECIFIED);
      if (mTransformation == PasswordTransformationMethod.getInstance()) {
        forceUpdate = true;
      }
    }

    boolean singleLine = !isMultilineInputType(type);

    // We need to update the single line mode if it has changed or we
    // were previously in password mode.
    if (mSingleLine != singleLine || forceUpdate) {
      // Change single line mode, but only change the transformation if
      // we are not in password mode.
      applySingleLine(singleLine, !isPassword, true, true);
    }

    if (!isSuggestionsEnabled()) {
      setTextInternal(removeSuggestionSpans(mText));
    }

    InputMethodManager imm = getInputMethodManager();
    if (imm != null) imm.restartInput(this);
  }

  /**
   * It would be better to rely on the input type for everything. A password inputType should have
   * a password transformation. We should hence use isPasswordInputType instead of this method.
   *
   * We should:
   * - Call setInputType in setKeyListener instead of changing the input type directly (which
   * would install the correct transformation).
   * - Refuse the installation of a non-password transformation in setTransformation if the input
   * type is password.
   *
   * However, this is like this for legacy reasons and we cannot break existing apps. This method
   * is useful since it matches what the user can see (obfuscated text or not).
   *
   * @return true if the current transformation method is of the password type.
   */
  boolean hasPasswordTransformationMethod() {
    return mTransformation instanceof PasswordTransformationMethod;
  }

  /**
   * Returns true if the current inputType is any type of password.
   *
   * @hide
   */
  public boolean isAnyPasswordInputType() {
    final int inputType = getInputType();
    return isPasswordInputType(inputType) || isVisiblePasswordInputType(inputType);
  }

  static boolean isPasswordInputType(int inputType) {
    final int variation =
      inputType & (EditorInfo.TYPE_MASK_CLASS | EditorInfo.TYPE_MASK_VARIATION);
    return variation
           == (EditorInfo.TYPE_CLASS_TEXT | EditorInfo.TYPE_TEXT_VARIATION_PASSWORD)
           || variation
              == (EditorInfo.TYPE_CLASS_TEXT | EditorInfo.TYPE_TEXT_VARIATION_WEB_PASSWORD)
           || variation
              == (EditorInfo.TYPE_CLASS_NUMBER | EditorInfo.TYPE_NUMBER_VARIATION_PASSWORD);
  }

  private static boolean isVisiblePasswordInputType(int inputType) {
    final int variation =
      inputType & (EditorInfo.TYPE_MASK_CLASS | EditorInfo.TYPE_MASK_VARIATION);
    return variation
           == (EditorInfo.TYPE_CLASS_TEXT | EditorInfo.TYPE_TEXT_VARIATION_VISIBLE_PASSWORD);
  }

  /**
   * Directly change the content type integer of the text view, without
   * modifying any other state.
   * @see #setInputType(int)
   * @see android.text.InputType
   * @attr ref android.R.styleable#TextView_inputType
   */
  public void setRawInputType(int type) {
    if (type == InputType.TYPE_NULL && mEditor == null) return; //TYPE_NULL is the default value
    createEditorIfNeeded();
    mEditor.mInputType = type;
  }

  @Override
  public String[] getAutofillHints() {
    String[] hints = super.getAutofillHints();
    if (isAnyPasswordInputType()) {
      if (!ArrayUtils.contains(hints, AUTOFILL_HINT_PASSWORD_AUTO)) {
        hints = ArrayUtils.appendElement(String.class, hints,
                                         AUTOFILL_HINT_PASSWORD_AUTO);
      }
    }
    return hints;
  }

  /**
   * @return {@code null} if the key listener should use pre-O (locale-independent). Otherwise
   *         a {@code Locale} object that can be used to customize key various listeners.
   * @see DateKeyListener#getInstance(Locale)
   * @see DateTimeKeyListener#getInstance(Locale)
   * @see DigitsKeyListener#getInstance(Locale)
   * @see TimeKeyListener#getInstance(Locale)
   */
  @Nullable
  private Locale getCustomLocaleForKeyListenerOrNull() {
    if (!mUseInternationalizedInput) {
      // If the application does not target O, stick to the previous behavior.
      return null;
    }
    final LocaleList locales = getImeHintLocales();
    if (locales == null) {
      // If the application does not explicitly specify IME hint locale, also stick to the
      // previous behavior.
      return null;
    }
    return locales.get(0);
  }

  @UnsupportedAppUsage
  private void setInputType(int type, boolean direct) {
    final int cls = type & EditorInfo.TYPE_MASK_CLASS;
    KeyListener input;
    if (cls == EditorInfo.TYPE_CLASS_TEXT) {
      boolean autotext = (type & EditorInfo.TYPE_TEXT_FLAG_AUTO_CORRECT) != 0;
      TextKeyListener.Capitalize cap;
      if ((type & EditorInfo.TYPE_TEXT_FLAG_CAP_CHARACTERS) != 0) {
        cap = TextKeyListener.Capitalize.CHARACTERS;
      } else if ((type & EditorInfo.TYPE_TEXT_FLAG_CAP_WORDS) != 0) {
        cap = TextKeyListener.Capitalize.WORDS;
      } else if ((type & EditorInfo.TYPE_TEXT_FLAG_CAP_SENTENCES) != 0) {
        cap = TextKeyListener.Capitalize.SENTENCES;
      } else {
        cap = TextKeyListener.Capitalize.NONE;
      }
      input = TextKeyListener.getInstance(autotext, cap);
    } else if (cls == EditorInfo.TYPE_CLASS_NUMBER) {
      final Locale locale = getCustomLocaleForKeyListenerOrNull();
      input = DigitsKeyListener.getInstance(
        locale,
        (type & EditorInfo.TYPE_NUMBER_FLAG_SIGNED) != 0,
        (type & EditorInfo.TYPE_NUMBER_FLAG_DECIMAL) != 0);
      if (locale != null) {
        // Override type, if necessary for i18n.
        int newType = input.getInputType();
        final int newClass = newType & EditorInfo.TYPE_MASK_CLASS;
        if (newClass != EditorInfo.TYPE_CLASS_NUMBER) {
          // The class is different from the original class. So we need to override
          // 'type'. But we want to keep the password flag if it's there.
          if ((type & EditorInfo.TYPE_NUMBER_VARIATION_PASSWORD) != 0) {
            newType |= EditorInfo.TYPE_TEXT_VARIATION_PASSWORD;
          }
          type = newType;
        }
      }
    } else if (cls == EditorInfo.TYPE_CLASS_DATETIME) {
      final Locale locale = getCustomLocaleForKeyListenerOrNull();
      switch (type & EditorInfo.TYPE_MASK_VARIATION) {
        case EditorInfo.TYPE_DATETIME_VARIATION_DATE:
          input = DateKeyListener.getInstance(locale);
          break;
        case EditorInfo.TYPE_DATETIME_VARIATION_TIME:
          input = TimeKeyListener.getInstance(locale);
          break;
        default:
          input = DateTimeKeyListener.getInstance(locale);
          break;
      }
      if (mUseInternationalizedInput) {
        type = input.getInputType(); // Override type, if necessary for i18n.
      }
    } else if (cls == EditorInfo.TYPE_CLASS_PHONE) {
      input = DialerKeyListener.getInstance();
    } else {
      input = TextKeyListener.getInstance();
    }
    setRawInputType(type);
    mListenerChanged = false;
    if (direct) {
      createEditorIfNeeded();
      mEditor.mKeyListener = input;
    } else {
      setKeyListenerOnly(input);
    }
  }

  /**
   * Get the type of the editable content.
   *
   * @see #setInputType(int)
   * @see android.text.InputType
   */
  @InspectableProperty(flagMapping = {
    @FlagEntry(name = "none", mask = 0xffffffff, target = InputType.TYPE_NULL),
    @FlagEntry(
      name = "text",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_VARIATION_NORMAL),
    @FlagEntry(
      name = "textUri",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_VARIATION_URI),
    @FlagEntry(
      name = "textEmailAddress",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT
               | InputType.TYPE_TEXT_VARIATION_EMAIL_ADDRESS),
    @FlagEntry(
      name = "textEmailSubject",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT
               | InputType.TYPE_TEXT_VARIATION_EMAIL_SUBJECT),
    @FlagEntry(
      name = "textShortMessage",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT
               | InputType.TYPE_TEXT_VARIATION_SHORT_MESSAGE),
    @FlagEntry(
      name = "textLongMessage",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT
               | InputType.TYPE_TEXT_VARIATION_LONG_MESSAGE),
    @FlagEntry(
      name = "textPersonName",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT
               | InputType.TYPE_TEXT_VARIATION_PERSON_NAME),
    @FlagEntry(
      name = "textPostalAddress",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT
               | InputType.TYPE_TEXT_VARIATION_POSTAL_ADDRESS),
    @FlagEntry(
      name = "textPassword",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_VARIATION_PASSWORD),
    @FlagEntry(
      name = "textVisiblePassword",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT
               | InputType.TYPE_TEXT_VARIATION_VISIBLE_PASSWORD),
    @FlagEntry(
      name = "textWebEditText",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT
               | InputType.TYPE_TEXT_VARIATION_WEB_EDIT_TEXT),
    @FlagEntry(
      name = "textFilter",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_VARIATION_FILTER),
    @FlagEntry(
      name = "textPhonetic",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_VARIATION_PHONETIC),
    @FlagEntry(
      name = "textWebEmailAddress",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT
               | InputType.TYPE_TEXT_VARIATION_WEB_EMAIL_ADDRESS),
    @FlagEntry(
      name = "textWebPassword",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_TEXT
               | InputType.TYPE_TEXT_VARIATION_WEB_PASSWORD),
    @FlagEntry(
      name = "number",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_NUMBER | InputType.TYPE_NUMBER_VARIATION_NORMAL),
    @FlagEntry(
      name = "numberPassword",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_NUMBER
               | InputType.TYPE_NUMBER_VARIATION_PASSWORD),
    @FlagEntry(
      name = "phone",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_PHONE),
    @FlagEntry(
      name = "datetime",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_DATETIME
               | InputType.TYPE_DATETIME_VARIATION_NORMAL),
    @FlagEntry(
      name = "date",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_DATETIME
               | InputType.TYPE_DATETIME_VARIATION_DATE),
    @FlagEntry(
      name = "time",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_VARIATION,
      target = InputType.TYPE_CLASS_DATETIME
               | InputType.TYPE_DATETIME_VARIATION_TIME),
    @FlagEntry(
      name = "textCapCharacters",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_FLAGS,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_FLAG_CAP_CHARACTERS),
    @FlagEntry(
      name = "textCapWords",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_FLAGS,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_FLAG_CAP_WORDS),
    @FlagEntry(
      name = "textCapSentences",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_FLAGS,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_FLAG_CAP_SENTENCES),
    @FlagEntry(
      name = "textAutoCorrect",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_FLAGS,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_FLAG_AUTO_CORRECT),
    @FlagEntry(
      name = "textAutoComplete",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_FLAGS,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_FLAG_AUTO_COMPLETE),
    @FlagEntry(
      name = "textMultiLine",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_FLAGS,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_FLAG_MULTI_LINE),
    @FlagEntry(
      name = "textImeMultiLine",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_FLAGS,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_FLAG_IME_MULTI_LINE),
    @FlagEntry(
      name = "textNoSuggestions",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_FLAGS,
      target = InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_FLAG_NO_SUGGESTIONS),
    @FlagEntry(
      name = "numberSigned",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_FLAGS,
      target = InputType.TYPE_CLASS_NUMBER | InputType.TYPE_NUMBER_FLAG_SIGNED),
    @FlagEntry(
      name = "numberDecimal",
      mask = InputType.TYPE_MASK_CLASS | InputType.TYPE_MASK_FLAGS,
      target = InputType.TYPE_CLASS_NUMBER | InputType.TYPE_NUMBER_FLAG_DECIMAL),
  })
  public int getInputType() {
    return mEditor == null ? EditorInfo.TYPE_NULL : mEditor.mInputType;
  }

  /**
   * Change the editor type integer associated with the text view, which
   * is reported to an Input Method Editor (IME) with {@link EditorInfo#imeOptions}
   * when it has focus.
   * @see #getImeOptions
   * @see android.view.inputmethod.EditorInfo
   * @attr ref android.R.styleable#TextView_imeOptions
   */
  public void setImeOptions(int imeOptions) {
    createEditorIfNeeded();
    mEditor.createInputContentTypeIfNeeded();
    mEditor.mInputContentType.imeOptions = imeOptions;
  }

  /**
   * Get the type of the Input Method Editor (IME).
   * @return the type of the IME
   * @see #setImeOptions(int)
   * @see EditorInfo
   */
  @InspectableProperty(flagMapping = {
    @FlagEntry(name = "normal", mask = 0xffffffff, target = EditorInfo.IME_NULL),
    @FlagEntry(
      name = "actionUnspecified",
      mask = EditorInfo.IME_MASK_ACTION,
      target = EditorInfo.IME_ACTION_UNSPECIFIED),
    @FlagEntry(
      name = "actionNone",
      mask = EditorInfo.IME_MASK_ACTION,
      target = EditorInfo.IME_ACTION_NONE),
    @FlagEntry(
      name = "actionGo",
      mask = EditorInfo.IME_MASK_ACTION,
      target = EditorInfo.IME_ACTION_GO),
    @FlagEntry(
      name = "actionSearch",
      mask = EditorInfo.IME_MASK_ACTION,
      target = EditorInfo.IME_ACTION_SEARCH),
    @FlagEntry(
      name = "actionSend",
      mask = EditorInfo.IME_MASK_ACTION,
      target = EditorInfo.IME_ACTION_SEND),
    @FlagEntry(
      name = "actionNext",
      mask = EditorInfo.IME_MASK_ACTION,
      target = EditorInfo.IME_ACTION_NEXT),
    @FlagEntry(
      name = "actionDone",
      mask = EditorInfo.IME_MASK_ACTION,
      target = EditorInfo.IME_ACTION_DONE),
    @FlagEntry(
      name = "actionPrevious",
      mask = EditorInfo.IME_MASK_ACTION,
      target = EditorInfo.IME_ACTION_PREVIOUS),
    @FlagEntry(name = "flagForceAscii", target = EditorInfo.IME_FLAG_FORCE_ASCII),
    @FlagEntry(name = "flagNavigateNext", target = EditorInfo.IME_FLAG_NAVIGATE_NEXT),
    @FlagEntry(
      name = "flagNavigatePrevious",
      target = EditorInfo.IME_FLAG_NAVIGATE_PREVIOUS),
    @FlagEntry(
      name = "flagNoAccessoryAction",
      target = EditorInfo.IME_FLAG_NO_ACCESSORY_ACTION),
    @FlagEntry(name = "flagNoEnterAction", target = EditorInfo.IME_FLAG_NO_ENTER_ACTION),
    @FlagEntry(name = "flagNoExtractUi", target = EditorInfo.IME_FLAG_NO_EXTRACT_UI),
    @FlagEntry(name = "flagNoFullscreen", target = EditorInfo.IME_FLAG_NO_FULLSCREEN),
    @FlagEntry(
      name = "flagNoPersonalizedLearning",
      target = EditorInfo.IME_FLAG_NO_PERSONALIZED_LEARNING),
  })
  public int getImeOptions() {
    return mEditor != null && mEditor.mInputContentType != null
           ? mEditor.mInputContentType.imeOptions : EditorInfo.IME_NULL;
  }

  /**
   * Change the custom IME action associated with the text view, which
   * will be reported to an IME with {@link EditorInfo#actionLabel}
   * and {@link EditorInfo#actionId} when it has focus.
   * @see #getImeActionLabel
   * @see #getImeActionId
   * @see android.view.inputmethod.EditorInfo
   * @attr ref android.R.styleable#TextView_imeActionLabel
   * @attr ref android.R.styleable#TextView_imeActionId
   */
  public void setImeActionLabel(CharSequence label, int actionId) {
    createEditorIfNeeded();
    mEditor.createInputContentTypeIfNeeded();
    mEditor.mInputContentType.imeActionLabel = label;
    mEditor.mInputContentType.imeActionId = actionId;
  }

  /**
   * Get the IME action label previous set with {@link #setImeActionLabel}.
   *
   * @see #setImeActionLabel
   * @see android.view.inputmethod.EditorInfo
   */
  @InspectableProperty
  public CharSequence getImeActionLabel() {
    return mEditor != null && mEditor.mInputContentType != null
           ? mEditor.mInputContentType.imeActionLabel : null;
  }

  /**
   * Get the IME action ID previous set with {@link #setImeActionLabel}.
   *
   * @see #setImeActionLabel
   * @see android.view.inputmethod.EditorInfo
   */
  @InspectableProperty
  public int getImeActionId() {
    return mEditor != null && mEditor.mInputContentType != null
           ? mEditor.mInputContentType.imeActionId : 0;
  }

  /**
   * Set a special listener to be called when an action is performed
   * on the text view.  This will be called when the enter key is pressed,
   * or when an action supplied to the IME is selected by the user.  Setting
   * this means that the normal hard key event will not insert a newline
   * into the text view, even if it is multi-line; holding down the ALT
   * modifier will, however, allow the user to insert a newline character.
   */
  public void setOnEditorActionListener(OnEditorActionListener l) {
    createEditorIfNeeded();
    mEditor.createInputContentTypeIfNeeded();
    mEditor.mInputContentType.onEditorActionListener = l;
  }

  /**
   * Called when an attached input method calls
   * {@link InputConnection#performEditorAction(int)
   * InputConnection.performEditorAction()}
   * for this text view.  The default implementation will call your action
   * listener supplied to {@link #setOnEditorActionListener}, or perform
   * a standard operation for {@link EditorInfo#IME_ACTION_NEXT
   * EditorInfo.IME_ACTION_NEXT}, {@link EditorInfo#IME_ACTION_PREVIOUS
   * EditorInfo.IME_ACTION_PREVIOUS}, or {@link EditorInfo#IME_ACTION_DONE
   * EditorInfo.IME_ACTION_DONE}.
   *
   * <p>For backwards compatibility, if no IME options have been set and the
   * text view would not normally advance focus on enter, then
   * the NEXT and DONE actions received here will be turned into an enter
   * key down/up pair to go through the normal key handling.
   *
   * @param actionCode The code of the action being performed.
   *
   * @see #setOnEditorActionListener
   */
  public void onEditorAction(int actionCode) {
    final Editor.InputContentType ict = mEditor == null ? null : mEditor.mInputContentType;
    if (ict != null) {
      if (ict.onEditorActionListener != null) {
        if (ict.onEditorActionListener.onEditorAction(this,
                                                      actionCode, null)) {
          return;
        }
      }

      // This is the handling for some default action.
      // Note that for backwards compatibility we don't do this
      // default handling if explicit ime options have not been given,
      // instead turning this into the normal enter key codes that an
      // app may be expecting.
      if (actionCode == EditorInfo.IME_ACTION_NEXT) {
        View v = focusSearch(FOCUS_FORWARD);
        if (v != null) {
          if (!v.requestFocus(FOCUS_FORWARD)) {
            throw new IllegalStateException("focus search returned a view "
                                            + "that wasn't able to take focus!");
          }
        }
        return;

      } else if (actionCode == EditorInfo.IME_ACTION_PREVIOUS) {
        View v = focusSearch(FOCUS_BACKWARD);
        if (v != null) {
          if (!v.requestFocus(FOCUS_BACKWARD)) {
            throw new IllegalStateException("focus search returned a view "
                                            + "that wasn't able to take focus!");
          }
        }
        return;

      } else if (actionCode == EditorInfo.IME_ACTION_DONE) {
        InputMethodManager imm = getInputMethodManager();
        if (imm != null) {
          imm.hideSoftInputFromView(this, 0);
        }
        return;
      }
    }

    ViewRootImpl viewRootImpl = getViewRootImpl();
    if (viewRootImpl != null) {
      long eventTime = SystemClock.uptimeMillis();
      viewRootImpl.dispatchKeyFromIme(
        new KeyEvent(eventTime, eventTime,
                     KeyEvent.ACTION_DOWN, KeyEvent.KEYCODE_ENTER, 0, 0,
                     KeyCharacterMap.VIRTUAL_KEYBOARD, 0,
                     KeyEvent.FLAG_SOFT_KEYBOARD | KeyEvent.FLAG_KEEP_TOUCH_MODE
                     | KeyEvent.FLAG_EDITOR_ACTION));
      viewRootImpl.dispatchKeyFromIme(
        new KeyEvent(SystemClock.uptimeMillis(), eventTime,
                     KeyEvent.ACTION_UP, KeyEvent.KEYCODE_ENTER, 0, 0,
                     KeyCharacterMap.VIRTUAL_KEYBOARD, 0,
                     KeyEvent.FLAG_SOFT_KEYBOARD | KeyEvent.FLAG_KEEP_TOUCH_MODE
                     | KeyEvent.FLAG_EDITOR_ACTION));
    }
  }

  /**
   * Set the private content type of the text, which is the
   * {@link EditorInfo#privateImeOptions EditorInfo.privateImeOptions}
   * field that will be filled in when creating an input connection.
   *
   * @see #getPrivateImeOptions()
   * @see EditorInfo#privateImeOptions
   * @attr ref android.R.styleable#TextView_privateImeOptions
   */
  public void setPrivateImeOptions(String type) {
    createEditorIfNeeded();
    mEditor.createInputContentTypeIfNeeded();
    mEditor.mInputContentType.privateImeOptions = type;
  }

  /**
   * Get the private type of the content.
   *
   * @see #setPrivateImeOptions(String)
   * @see EditorInfo#privateImeOptions
   */
  @InspectableProperty
  public String getPrivateImeOptions() {
    return mEditor != null && mEditor.mInputContentType != null
           ? mEditor.mInputContentType.privateImeOptions : null;
  }

  /**
   * Set the extra input data of the text, which is the
   * {@link EditorInfo#extras TextBoxAttribute.extras}
   * Bundle that will be filled in when creating an input connection.  The
   * given integer is the resource identifier of an XML resource holding an
   * {@link android.R.styleable#InputExtras &lt;input-extras&gt;} XML tree.
   *
   * @see #getInputExtras(boolean)
   * @see EditorInfo#extras
   * @attr ref android.R.styleable#TextView_editorExtras
   */
  public void setInputExtras(@XmlRes int xmlResId) throws XmlPullParserException, IOException {
    createEditorIfNeeded();
    XmlResourceParser parser = getResources().getXml(xmlResId);
    mEditor.createInputContentTypeIfNeeded();
    mEditor.mInputContentType.extras = new Bundle();
    getResources().parseBundleExtras(parser, mEditor.mInputContentType.extras);
  }

  /**
   * Retrieve the input extras currently associated with the text view, which
   * can be viewed as well as modified.
   *
   * @param create If true, the extras will be created if they don't already
   * exist.  Otherwise, null will be returned if none have been created.
   * @see #setInputExtras(int)
   * @see EditorInfo#extras
   * @attr ref android.R.styleable#TextView_editorExtras
   */
  public Bundle getInputExtras(boolean create) {
    if (mEditor == null && !create) return null;
    createEditorIfNeeded();
    if (mEditor.mInputContentType == null) {
      if (!create) return null;
      mEditor.createInputContentTypeIfNeeded();
    }
    if (mEditor.mInputContentType.extras == null) {
      if (!create) return null;
      mEditor.mInputContentType.extras = new Bundle();
    }
    return mEditor.mInputContentType.extras;
  }

  /**
   * Change "hint" locales associated with the text view, which will be reported to an IME with
   * {@link EditorInfo#hintLocales} when it has focus.
   *
   * Starting with Android O, this also causes internationalized listeners to be created (or
   * change locale) based on the first locale in the input locale list.
   *
   * <p><strong>Note:</strong> If you want new "hint" to take effect immediately you need to
   * call {@link InputMethodManager#restartInput(View)}.</p>
   * @param hintLocales List of the languages that the user is supposed to switch to no matter
   * what input method subtype is currently used. Set {@code null} to clear the current "hint".
   * @see #getImeHintLocales()
   * @see android.view.inputmethod.EditorInfo#hintLocales
   */
  public void setImeHintLocales(@Nullable LocaleList hintLocales) {
    createEditorIfNeeded();
    mEditor.createInputContentTypeIfNeeded();
    mEditor.mInputContentType.imeHintLocales = hintLocales;
    if (mUseInternationalizedInput) {
      changeListenerLocaleTo(hintLocales == null ? null : hintLocales.get(0));
    }
  }

  /**
   * @return The current languages list "hint". {@code null} when no "hint" is available.
   * @see #setImeHintLocales(LocaleList)
   * @see android.view.inputmethod.EditorInfo#hintLocales
   */
  @Nullable
  public LocaleList getImeHintLocales() {
    if (mEditor == null) {
      return null;
    }
    if (mEditor.mInputContentType == null) {
      return null;
    }
    return mEditor.mInputContentType.imeHintLocales;
  }

  /**
   * Returns the error message that was set to be displayed with
   * {@link #setError}, or <code>null</code> if no error was set
   * or if it the error was cleared by the widget after user input.
   */
  public CharSequence getError() {
    return mEditor == null ? null : mEditor.mError;
  }

  /**
   * Sets the right-hand compound drawable of the TextView to the "error"
   * icon and sets an error message that will be displayed in a popup when
   * the TextView has focus.  The icon and error message will be reset to
   * null when any key events cause changes to the TextView's text.  If the
   * <code>error</code> is <code>null</code>, the error message and icon
   * will be cleared.
   */
  @android.view.RemotableViewMethod
  public void setError(CharSequence error) {
    if (error == null) {
      setError(null, null);
    } else {
      Drawable dr = getContext().getDrawable(
        com.android.internal.R.drawable.indicator_input_error);

      dr.setBounds(0, 0, dr.getIntrinsicWidth(), dr.getIntrinsicHeight());
      setError(error, dr);
    }
  }

  /**
   * Sets the right-hand compound drawable of the TextView to the specified
   * icon and sets an error message that will be displayed in a popup when
   * the TextView has focus.  The icon and error message will be reset to
   * null when any key events cause changes to the TextView's text.  The
   * drawable must already have had {@link Drawable#setBounds} set on it.
   * If the <code>error</code> is <code>null</code>, the error message will
   * be cleared (and you should provide a <code>null</code> icon as well).
   */
  public void setError(CharSequence error, Drawable icon) {
    createEditorIfNeeded();
    mEditor.setError(error, icon);
    notifyViewAccessibilityStateChangedIfNeeded(
      AccessibilityEvent.CONTENT_CHANGE_TYPE_ERROR
      | AccessibilityEvent.CONTENT_CHANGE_TYPE_CONTENT_INVALID);
  }

  @Override
  protected boolean setFrame(int l, int t, int r, int b) {
    boolean result = super.setFrame(l, t, r, b);

    if (mEditor != null) mEditor.setFrame();

    restartMarqueeIfNeeded();

    return result;
  }

  private void restartMarqueeIfNeeded() {
    if (mRestartMarquee && mEllipsize == TextUtils.TruncateAt.MARQUEE) {
      mRestartMarquee = false;
      startMarquee();
    }
  }

  /**
   * Sets the list of input filters that will be used if the buffer is
   * Editable. Has no effect otherwise.
   *
   * @attr ref android.R.styleable#TextView_maxLength
   */
  public void setFilters(InputFilter[] filters) {
    if (filters == null) {
      throw new IllegalArgumentException();
    }

    mFilters = filters;

    if (mText instanceof Editable) {
      setFilters((Editable) mText, filters);
    }
  }

  /**
   * Sets the list of input filters on the specified Editable,
   * and includes mInput in the list if it is an InputFilter.
   */
  private void setFilters(Editable e, InputFilter[] filters) {
    if (mEditor != null) {
      final boolean undoFilter = mEditor.mUndoInputFilter != null;
      final boolean keyFilter = mEditor.mKeyListener instanceof InputFilter;
      int num = 0;
      if (undoFilter) num++;
      if (keyFilter) num++;
      if (num > 0) {
        InputFilter[] nf = new InputFilter[filters.length + num];

        System.arraycopy(filters, 0, nf, 0, filters.length);
        num = 0;
        if (undoFilter) {
          nf[filters.length] = mEditor.mUndoInputFilter;
          num++;
        }
        if (keyFilter) {
          nf[filters.length + num] = (InputFilter) mEditor.mKeyListener;
        }

        e.setFilters(nf);
        return;
      }
    }
    e.setFilters(filters);
  }

  /**
   * Returns the current list of input filters.
   *
   * @attr ref android.R.styleable#TextView_maxLength
   */
  public InputFilter[] getFilters() {
    return mFilters;
  }

  /////////////////////////////////////////////////////////////////////////

  private int getBoxHeight(Layout l) {
    Insets opticalInsets = isLayoutModeOptical(mParent) ? getOpticalInsets() : Insets.NONE;
    int padding = (l == mHintLayout)
                  ? getCompoundPaddingTop() + getCompoundPaddingBottom()
                  : getExtendedPaddingTop() + getExtendedPaddingBottom();
    return getMeasuredHeight() - padding + opticalInsets.top + opticalInsets.bottom;
  }

  @UnsupportedAppUsage
  int getVerticalOffset(boolean forceNormal) {
    int voffset = 0;
    final int gravity = mGravity & Gravity.VERTICAL_GRAVITY_MASK;

    Layout l = mLayout;
    if (!forceNormal && mText.length() == 0 && mHintLayout != null) {
      l = mHintLayout;
    }

    if (gravity != Gravity.TOP) {
      int boxht = getBoxHeight(l);
      int textht = l.getHeight();

      if (textht < boxht) {
        if (gravity == Gravity.BOTTOM) {
          voffset = boxht - textht;
        } else { // (gravity == Gravity.CENTER_VERTICAL)
          voffset = (boxht - textht) >> 1;
        }
      }
    }
    return voffset;
  }

  private int getBottomVerticalOffset(boolean forceNormal) {
    int voffset = 0;
    final int gravity = mGravity & Gravity.VERTICAL_GRAVITY_MASK;

    Layout l = mLayout;
    if (!forceNormal && mText.length() == 0 && mHintLayout != null) {
      l = mHintLayout;
    }

    if (gravity != Gravity.BOTTOM) {
      int boxht = getBoxHeight(l);
      int textht = l.getHeight();

      if (textht < boxht) {
        if (gravity == Gravity.TOP) {
          voffset = boxht - textht;
        } else { // (gravity == Gravity.CENTER_VERTICAL)
          voffset = (boxht - textht) >> 1;
        }
      }
    }
    return voffset;
  }

  void invalidateCursorPath() {
    if (mHighlightPathBogus) {
      invalidateCursor();
    } else {
      final int horizontalPadding = getCompoundPaddingLeft();
      final int verticalPadding = getExtendedPaddingTop() + getVerticalOffset(true);

      if (mEditor.mDrawableForCursor == null) {
        synchronized (TEMP_RECTF) {
          /*
           * The reason for this concern about the thickness of the
           * cursor and doing the floor/ceil on the coordinates is that
           * some EditTexts (notably textfields in the Browser) have
           * anti-aliased text where not all the characters are
           * necessarily at integer-multiple locations.  This should
           * make sure the entire cursor gets invalidated instead of
           * sometimes missing half a pixel.
           */
          float thick = (float) Math.ceil(mTextPaint.getStrokeWidth());
          if (thick < 1.0f) {
            thick = 1.0f;
          }

          thick /= 2.0f;

          // mHighlightPath is guaranteed to be non null at that point.
          mHighlightPath.computeBounds(TEMP_RECTF, false);

          invalidate((int) Math.floor(horizontalPadding + TEMP_RECTF.left - thick),
                     (int) Math.floor(verticalPadding + TEMP_RECTF.top - thick),
                     (int) Math.ceil(horizontalPadding + TEMP_RECTF.right + thick),
                     (int) Math.ceil(verticalPadding + TEMP_RECTF.bottom + thick));
        }
      } else {
        final Rect bounds = mEditor.mDrawableForCursor.getBounds();
        invalidate(bounds.left + horizontalPadding, bounds.top + verticalPadding,
                   bounds.right + horizontalPadding, bounds.bottom + verticalPadding);
      }
    }
  }

  void invalidateCursor() {
    int where = getSelectionEnd();

    invalidateCursor(where, where, where);
  }

  private void invalidateCursor(int a, int b, int c) {
    if (a >= 0 || b >= 0 || c >= 0) {
      int start = Math.min(Math.min(a, b), c);
      int end = Math.max(Math.max(a, b), c);
      invalidateRegion(start, end, true /* Also invalidates blinking cursor */);
    }
  }

  /**
   * Invalidates the region of text enclosed between the start and end text offsets.
   */
  void invalidateRegion(int start, int end, boolean invalidateCursor) {
    if (mLayout == null) {
      invalidate();
    } else {
      start = originalToTransformed(start, OffsetMapping.MAP_STRATEGY_CURSOR);
      end = originalToTransformed(end, OffsetMapping.MAP_STRATEGY_CURSOR);
      int lineStart = mLayout.getLineForOffset(start);
      int top = mLayout.getLineTop(lineStart);

      // This is ridiculous, but the descent from the line above
      // can hang down into the line we really want to redraw,
      // so we have to invalidate part of the line above to make
      // sure everything that needs to be redrawn really is.
      // (But not the whole line above, because that would cause
      // the same problem with the descenders on the line above it!)
      if (lineStart > 0) {
        top -= mLayout.getLineDescent(lineStart - 1);
      }

      int lineEnd;

      if (start == end) {
        lineEnd = lineStart;
      } else {
        lineEnd = mLayout.getLineForOffset(end);
      }

      int bottom = mLayout.getLineBottom(lineEnd);

      // mEditor can be null in case selection is set programmatically.
      if (invalidateCursor && mEditor != null && mEditor.mDrawableForCursor != null) {
        final Rect bounds = mEditor.mDrawableForCursor.getBounds();
        top = Math.min(top, bounds.top);
        bottom = Math.max(bottom, bounds.bottom);
      }

      final int compoundPaddingLeft = getCompoundPaddingLeft();
      final int verticalPadding = getExtendedPaddingTop() + getVerticalOffset(true);

      int left, right;
      if (lineStart == lineEnd && !invalidateCursor) {
        left = (int) mLayout.getPrimaryHorizontal(start);
        right = (int) (mLayout.getPrimaryHorizontal(end) + 1.0);
        left += compoundPaddingLeft;
        right += compoundPaddingLeft;
      } else {
        // Rectangle bounding box when the region spans several lines
        left = compoundPaddingLeft;
        right = getWidth() - getCompoundPaddingRight();
      }

      invalidate(mScrollX + left, verticalPadding + top,
                 mScrollX + right, verticalPadding + bottom);
    }
  }

  private void registerForPreDraw() {
    if (!mPreDrawRegistered) {
      getViewTreeObserver().addOnPreDrawListener(this);
      mPreDrawRegistered = true;
    }
  }

  private void unregisterForPreDraw() {
    getViewTreeObserver().removeOnPreDrawListener(this);
    mPreDrawRegistered = false;
    mPreDrawListenerDetached = false;
  }

  /**
   * {@inheritDoc}
   */
  @Override
  public boolean onPreDraw() {
    if (mLayout == null) {
      assumeLayout();
    }

    if (mMovement != null) {
      /* This code also provides auto-scrolling when a cursor is moved using a
       * CursorController (insertion point or selection limits).
       * For selection, ensure start or end is visible depending on controller's state.
       */
      int curs = getSelectionEnd();
      // Do not create the controller if it is not already created.
      if (mEditor != null && mEditor.mSelectionModifierCursorController != null
          && mEditor.mSelectionModifierCursorController.isSelectionStartDragged()) {
        curs = getSelectionStart();
      }

      /*
       * TODO: This should really only keep the end in view if
       * it already was before the text changed.  I'm not sure
       * of a good way to tell from here if it was.
       */
      if (curs < 0 && (mGravity & Gravity.VERTICAL_GRAVITY_MASK) == Gravity.BOTTOM) {
        curs = mText.length();
      }

      if (curs >= 0) {
        bringPointIntoView(curs);
      }
    } else {
      bringTextIntoView();
    }

    // This has to be checked here since:
    // - onFocusChanged cannot start it when focus is given to a view with selected text (after
    //   a screen rotation) since layout is not yet initialized at that point.
    if (mEditor != null && mEditor.mCreatedWithASelection) {
      mEditor.refreshTextActionMode();
      mEditor.mCreatedWithASelection = false;
    }

    unregisterForPreDraw();

    return true;
  }

  @Override
  protected void onAttachedToWindow() {
    super.onAttachedToWindow();

    if (mEditor != null) mEditor.onAttachedToWindow();

    if (mPreDrawListenerDetached) {
      getViewTreeObserver().addOnPreDrawListener(this);
      mPreDrawListenerDetached = false;
    }
  }

  /** @hide */
  @Override
  protected void onDetachedFromWindowInternal() {
    if (mPreDrawRegistered) {
      getViewTreeObserver().removeOnPreDrawListener(this);
      mPreDrawListenerDetached = true;
    }

    resetResolvedDrawables();

    if (mEditor != null) mEditor.onDetachedFromWindow();

    super.onDetachedFromWindowInternal();
  }

  @Override
  public void onScreenStateChanged(int screenState) {
    super.onScreenStateChanged(screenState);
    if (mEditor != null) mEditor.onScreenStateChanged(screenState);
  }

  @Override
  protected boolean isPaddingOffsetRequired() {
    return mShadowRadius != 0 || mDrawables != null;
  }

  @Override
  protected int getLeftPaddingOffset() {
    return getCompoundPaddingLeft() - mPaddingLeft
           + (int) Math.min(0, mShadowDx - mShadowRadius);
  }

  @Override
  protected int getTopPaddingOffset() {
    return (int) Math.min(0, mShadowDy - mShadowRadius);
  }

  @Override
  protected int getBottomPaddingOffset() {
    return (int) Math.max(0, mShadowDy + mShadowRadius);
  }

  @Override
  protected int getRightPaddingOffset() {
    return -(getCompoundPaddingRight() - mPaddingRight)
           + (int) Math.max(0, mShadowDx + mShadowRadius);
  }

  @Override
  protected boolean verifyDrawable(@NonNull Drawable who) {
    final boolean verified = super.verifyDrawable(who);
    if (!verified && mDrawables != null) {
      for (Drawable dr : mDrawables.mShowing) {
        if (who == dr) {
          return true;
        }
      }
    }
    return verified;
  }

  @Override
  public void jumpDrawablesToCurrentState() {
    super.jumpDrawablesToCurrentState();
    if (mDrawables != null) {
      for (Drawable dr : mDrawables.mShowing) {
        if (dr != null) {
          dr.jumpToCurrentState();
        }
      }
    }
  }

  @Override
  public void invalidateDrawable(@NonNull Drawable drawable) {
    boolean handled = false;

    if (verifyDrawable(drawable)) {
      final Rect dirty = drawable.getBounds();
      int scrollX = mScrollX;
      int scrollY = mScrollY;

      // IMPORTANT: The coordinates below are based on the coordinates computed
      // for each compound drawable in onDraw(). Make sure to update each section
      // accordingly.
      final TextView.Drawables drawables = mDrawables;
      if (drawables != null) {
        if (drawable == drawables.mShowing[Drawables.LEFT]) {
          final int compoundPaddingTop = getCompoundPaddingTop();
          final int compoundPaddingBottom = getCompoundPaddingBottom();
          final int vspace = mBottom - mTop - compoundPaddingBottom - compoundPaddingTop;

          scrollX += mPaddingLeft;
          scrollY += compoundPaddingTop + (vspace - drawables.mDrawableHeightLeft) / 2;
          handled = true;
        } else if (drawable == drawables.mShowing[Drawables.RIGHT]) {
          final int compoundPaddingTop = getCompoundPaddingTop();
          final int compoundPaddingBottom = getCompoundPaddingBottom();
          final int vspace = mBottom - mTop - compoundPaddingBottom - compoundPaddingTop;

          scrollX += (mRight - mLeft - mPaddingRight - drawables.mDrawableSizeRight);
          scrollY += compoundPaddingTop + (vspace - drawables.mDrawableHeightRight) / 2;
          handled = true;
        } else if (drawable == drawables.mShowing[Drawables.TOP]) {
          final int compoundPaddingLeft = getCompoundPaddingLeft();
          final int compoundPaddingRight = getCompoundPaddingRight();
          final int hspace = mRight - mLeft - compoundPaddingRight - compoundPaddingLeft;

          scrollX += compoundPaddingLeft + (hspace - drawables.mDrawableWidthTop) / 2;
          scrollY += mPaddingTop;
          handled = true;
        } else if (drawable == drawables.mShowing[Drawables.BOTTOM]) {
          final int compoundPaddingLeft = getCompoundPaddingLeft();
          final int compoundPaddingRight = getCompoundPaddingRight();
          final int hspace = mRight - mLeft - compoundPaddingRight - compoundPaddingLeft;

          scrollX += compoundPaddingLeft + (hspace - drawables.mDrawableWidthBottom) / 2;
          scrollY += (mBottom - mTop - mPaddingBottom - drawables.mDrawableSizeBottom);
          handled = true;
        }
      }

      if (handled) {
        invalidate(dirty.left + scrollX, dirty.top + scrollY,
                   dirty.right + scrollX, dirty.bottom + scrollY);
      }
    }

    if (!handled) {
      super.invalidateDrawable(drawable);
    }
  }

  @Override
  public boolean hasOverlappingRendering() {
    // horizontal fading edge causes SaveLayerAlpha, which doesn't support alpha modulation
    return ((getBackground() != null && getBackground().getCurrent() != null)
            || mSpannable != null || hasSelection() || isHorizontalFadingEdgeEnabled()
            || mShadowColor != 0);
  }

  /**
   *
   * Returns the state of the {@code textIsSelectable} flag (See
   * {@link #setTextIsSelectable setTextIsSelectable()}). Although you have to set this flag
   * to allow users to select and copy text in a non-editable TextView, the content of an
   * {@link EditText} can always be selected, independently of the value of this flag.
   * <p>
   *
   * @return True if the text displayed in this TextView can be selected by the user.
   *
   * @attr ref android.R.styleable#TextView_textIsSelectable
   */
  @InspectableProperty(name = "textIsSelectable")
  public boolean isTextSelectable() {
    return mEditor == null ? false : mEditor.mTextIsSelectable;
  }

  /**
   * Sets whether the content of this view is selectable by the user. The default is
   * {@code false}, meaning that the content is not selectable.
   * <p>
   * When you use a TextView to display a useful piece of information to the user (such as a
   * contact's address), make it selectable, so that the user can select and copy its
   * content. You can also use set the XML attribute
   * {@link android.R.styleable#TextView_textIsSelectable} to "true".
   * <p>
   * When you call this method to set the value of {@code textIsSelectable}, it sets
   * the flags {@code focusable}, {@code focusableInTouchMode}, {@code clickable},
   * and {@code longClickable} to the same value. These flags correspond to the attributes
   * {@link android.R.styleable#View_focusable android:focusable},
   * {@link android.R.styleable#View_focusableInTouchMode android:focusableInTouchMode},
   * {@link android.R.styleable#View_clickable android:clickable}, and
   * {@link android.R.styleable#View_longClickable android:longClickable}. To restore any of these
   * flags to a state you had set previously, call one or more of the following methods:
   * {@link #setFocusable(boolean) setFocusable()},
   * {@link #setFocusableInTouchMode(boolean) setFocusableInTouchMode()},
   * {@link #setClickable(boolean) setClickable()} or
   * {@link #setLongClickable(boolean) setLongClickable()}.
   *
   * @param selectable Whether the content of this TextView should be selectable.
   */
  public void setTextIsSelectable(boolean selectable) {
    if (!selectable && mEditor == null) return; // false is default value with no edit data

    createEditorIfNeeded();
    if (mEditor.mTextIsSelectable == selectable) return;

    mEditor.mTextIsSelectable = selectable;
    setFocusableInTouchMode(selectable);
    setFocusable(FOCUSABLE_AUTO);
    setClickable(selectable);
    setLongClickable(selectable);

    // mInputType should already be EditorInfo.TYPE_NULL and mInput should be null

    setMovementMethod(selectable ? ArrowKeyMovementMethod.getInstance() : null);
    setText(mText, selectable ? BufferType.SPANNABLE : BufferType.NORMAL);

    // Called by setText above, but safer in case of future code changes
    mEditor.prepareCursorControllers();
  }

  @Override
  protected int[] onCreateDrawableState(int extraSpace) {
    final int[] drawableState;

    if (mSingleLine) {
      drawableState = super.onCreateDrawableState(extraSpace);
    } else {
      drawableState = super.onCreateDrawableState(extraSpace + 1);
      mergeDrawableStates(drawableState, MULTILINE_STATE_SET);
    }

    if (isTextSelectable()) {
      // Disable pressed state, which was introduced when TextView was made clickable.
      // Prevents text color change.
      // setClickable(false) would have a similar effect, but it also disables focus changes
      // and long press actions, which are both needed by text selection.
      final int length = drawableState.length;
      for (int i = 0; i < length; i++) {
        if (drawableState[i] == R.attr.state_pressed) {
          final int[] nonPressedState = new int[length - 1];
          System.arraycopy(drawableState, 0, nonPressedState, 0, i);
          System.arraycopy(drawableState, i + 1, nonPressedState, i, length - i - 1);
          return nonPressedState;
        }
      }
    }

    return drawableState;
  }

  private void maybeUpdateHighlightPaths() {
    if (!mHighlightPathsBogus) {
      return;
    }

    if (mHighlightPaths != null) {
      mPathRecyclePool.addAll(mHighlightPaths);
      mHighlightPaths.clear();
      mHighlightPaints.clear();
    } else {
      mHighlightPaths = new ArrayList<>();
      mHighlightPaints = new ArrayList<>();
    }

    if (mHighlights != null) {
      for (int i = 0; i < mHighlights.getSize(); ++i) {
        final int[] ranges = mHighlights.getRanges(i);
        final Paint paint = mHighlights.getPaint(i);
        final Path path;
        if (mPathRecyclePool.isEmpty()) {
          path = new Path();
        } else {
          path = mPathRecyclePool.get(mPathRecyclePool.size() - 1);
          mPathRecyclePool.remove(mPathRecyclePool.size() - 1);
          path.reset();
        }

        boolean atLeastOnePathAdded = false;
        for (int j = 0; j < ranges.length / 2; ++j) {
          final int start = ranges[2 * j];
          final int end = ranges[2 * j + 1];
          if (start < end) {
            mLayout.getSelection(start, end, (left, top, right, bottom, layout) ->
              path.addRect(left, top, right, bottom, Path.Direction.CW)
            );
            atLeastOnePathAdded = true;
          }
        }
        if (atLeastOnePathAdded) {
          mHighlightPaths.add(path);
          mHighlightPaints.add(paint);
        }
      }
    }

    addSearchHighlightPaths();

    if (hasGesturePreviewHighlight()) {
      final Path path;
      if (mPathRecyclePool.isEmpty()) {
        path = new Path();
      } else {
        path = mPathRecyclePool.get(mPathRecyclePool.size() - 1);
        mPathRecyclePool.remove(mPathRecyclePool.size() - 1);
        path.reset();
      }
      mLayout.getSelectionPath(
        mGesturePreviewHighlightStart, mGesturePreviewHighlightEnd, path);
      mHighlightPaths.add(path);
      mHighlightPaints.add(mGesturePreviewHighlightPaint);
    }

    mHighlightPathsBogus = false;
  }

  private void addSearchHighlightPaths() {
    if (mSearchResultHighlights != null) {
      final Path searchResultPath;
      if (mPathRecyclePool.isEmpty()) {
        searchResultPath = new Path();
      } else {
        searchResultPath = mPathRecyclePool.get(mPathRecyclePool.size() - 1);
        mPathRecyclePool.remove(mPathRecyclePool.size() - 1);
        searchResultPath.reset();
      }
      final Path focusedSearchResultPath;
      if (mFocusedSearchResultIndex == FOCUSED_SEARCH_RESULT_INDEX_NONE) {
        focusedSearchResultPath = null;
      } else if (mPathRecyclePool.isEmpty()) {
        focusedSearchResultPath = new Path();
      } else {
        focusedSearchResultPath = mPathRecyclePool.get(mPathRecyclePool.size() - 1);
        mPathRecyclePool.remove(mPathRecyclePool.size() - 1);
        focusedSearchResultPath.reset();
      }

      boolean atLeastOnePathAdded = false;
      for (int j = 0; j < mSearchResultHighlights.length / 2; ++j) {
        final int start = mSearchResultHighlights[2 * j];
        final int end = mSearchResultHighlights[2 * j + 1];
        if (start < end) {
          if (j == mFocusedSearchResultIndex) {
            mLayout.getSelection(start, end, (left, top, right, bottom, layout) ->
              focusedSearchResultPath.addRect(left, top, right, bottom,
                                              Path.Direction.CW)
            );
          } else {
            mLayout.getSelection(start, end, (left, top, right, bottom, layout) ->
              searchResultPath.addRect(left, top, right, bottom,
                                       Path.Direction.CW)
            );
            atLeastOnePathAdded = true;
          }
        }
      }
      if (atLeastOnePathAdded) {
        if (mSearchResultHighlightPaint == null) {
          mSearchResultHighlightPaint = new Paint();
        }
        mSearchResultHighlightPaint.setColor(mSearchResultHighlightColor);
        mSearchResultHighlightPaint.setStyle(Paint.Style.FILL);
        mHighlightPaths.add(searchResultPath);
        mHighlightPaints.add(mSearchResultHighlightPaint);
      }
      if (focusedSearchResultPath != null) {
        if (mFocusedSearchResultHighlightPaint == null) {
          mFocusedSearchResultHighlightPaint = new Paint();
        }
        mFocusedSearchResultHighlightPaint.setColor(mFocusedSearchResultHighlightColor);
        mFocusedSearchResultHighlightPaint.setStyle(Paint.Style.FILL);
        mHighlightPaths.add(focusedSearchResultPath);
        mHighlightPaints.add(mFocusedSearchResultHighlightPaint);
      }
    }
  }

  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
  private Path getUpdatedHighlightPath() {
    Path highlight = null;
    Paint highlightPaint = mHighlightPaint;

    final int selStart = getSelectionStartTransformed();
    final int selEnd = getSelectionEndTransformed();
    if (mMovement != null && (isFocused() || isPressed()) && selStart >= 0) {
      if (selStart == selEnd) {
        if (mEditor != null && mEditor.shouldRenderCursor()) {
          if (mHighlightPathBogus) {
            if (mHighlightPath == null) mHighlightPath = new Path();
            mHighlightPath.reset();
            mLayout.getCursorPath(selStart, mHighlightPath, mText);
            mEditor.updateCursorPosition();
            mHighlightPathBogus = false;
          }

          // XXX should pass to skin instead of drawing directly
          highlightPaint.setColor(mCurTextColor);
          highlightPaint.setStyle(Paint.Style.STROKE);
          highlight = mHighlightPath;
        }
      } else {
        if (mHighlightPathBogus) {
          if (mHighlightPath == null) mHighlightPath = new Path();
          mHighlightPath.reset();
          mLayout.getSelectionPath(selStart, selEnd, mHighlightPath);
          mHighlightPathBogus = false;
        }

        // XXX should pass to skin instead of drawing directly
        highlightPaint.setColor(mHighlightColor);
        highlightPaint.setStyle(Paint.Style.FILL);

        highlight = mHighlightPath;
      }
    }
    return highlight;
  }

  /**
   * @hide
   */
  public int getHorizontalOffsetForDrawables() {
    return 0;
  }

  @Override
  protected void onDraw(Canvas canvas) {
    restartMarqueeIfNeeded();

    // Draw the background for this view
    super.onDraw(canvas);

    final int compoundPaddingLeft = getCompoundPaddingLeft();
    final int compoundPaddingTop = getCompoundPaddingTop();
    final int compoundPaddingRight = getCompoundPaddingRight();
    final int compoundPaddingBottom = getCompoundPaddingBottom();
    final int scrollX = mScrollX;
    final int scrollY = mScrollY;
    final int right = mRight;
    final int left = mLeft;
    final int bottom = mBottom;
    final int top = mTop;
    final boolean isLayoutRtl = isLayoutRtl();
    final int offset = getHorizontalOffsetForDrawables();
    final int leftOffset = isLayoutRtl ? 0 : offset;
    final int rightOffset = isLayoutRtl ? offset : 0;

    final Drawables dr = mDrawables;
    if (dr != null) {
      /*
       * Compound, not extended, because the icon is not clipped
       * if the text height is smaller.
       */

      int vspace = bottom - top - compoundPaddingBottom - compoundPaddingTop;
      int hspace = right - left - compoundPaddingRight - compoundPaddingLeft;

      // IMPORTANT: The coordinates computed are also used in invalidateDrawable()
      // Make sure to update invalidateDrawable() when changing this code.
      if (dr.mShowing[Drawables.LEFT] != null) {
        canvas.save();
        canvas.translate(scrollX + mPaddingLeft + leftOffset,
                         scrollY + compoundPaddingTop + (vspace - dr.mDrawableHeightLeft) / 2);
        dr.mShowing[Drawables.LEFT].draw(canvas);
        canvas.restore();
      }

      // IMPORTANT: The coordinates computed are also used in invalidateDrawable()
      // Make sure to update invalidateDrawable() when changing this code.
      if (dr.mShowing[Drawables.RIGHT] != null) {
        canvas.save();
        canvas.translate(scrollX + right - left - mPaddingRight
                         - dr.mDrawableSizeRight - rightOffset,
                         scrollY + compoundPaddingTop + (vspace - dr.mDrawableHeightRight) / 2);
        dr.mShowing[Drawables.RIGHT].draw(canvas);
        canvas.restore();
      }

      // IMPORTANT: The coordinates computed are also used in invalidateDrawable()
      // Make sure to update invalidateDrawable() when changing this code.
      if (dr.mShowing[Drawables.TOP] != null) {
        canvas.save();
        canvas.translate(scrollX + compoundPaddingLeft
                         + (hspace - dr.mDrawableWidthTop) / 2, scrollY + mPaddingTop);
        dr.mShowing[Drawables.TOP].draw(canvas);
        canvas.restore();
      }

      // IMPORTANT: The coordinates computed are also used in invalidateDrawable()
      // Make sure to update invalidateDrawable() when changing this code.
      if (dr.mShowing[Drawables.BOTTOM] != null) {
        canvas.save();
        canvas.translate(scrollX + compoundPaddingLeft
                         + (hspace - dr.mDrawableWidthBottom) / 2,
                         scrollY + bottom - top - mPaddingBottom - dr.mDrawableSizeBottom);
        dr.mShowing[Drawables.BOTTOM].draw(canvas);
        canvas.restore();
      }
    }

    int color = mCurTextColor;

    if (mLayout == null) {
      assumeLayout();
    }

    Layout layout = mLayout;

    if (mHint != null && !mHideHint && mText.length() == 0) {
      if (mHintTextColor != null) {
        color = mCurHintTextColor;
      }

      layout = mHintLayout;
    }

    mTextPaint.setColor(color);
    mTextPaint.drawableState = getDrawableState();

    canvas.save();
        /*  Would be faster if we didn't have to do this. Can we chop the
            (displayable) text so that we don't need to do this ever?
        */

    int extendedPaddingTop = getExtendedPaddingTop();
    int extendedPaddingBottom = getExtendedPaddingBottom();

    final int vspace = mBottom - mTop - compoundPaddingBottom - compoundPaddingTop;
    final int maxScrollY = mLayout.getHeight() - vspace;

    float clipLeft = compoundPaddingLeft + scrollX;
    float clipTop = (scrollY == 0) ? 0 : extendedPaddingTop + scrollY;
    float clipRight = right - left - getCompoundPaddingRight() + scrollX;
    float clipBottom = bottom - top + scrollY
                       - ((scrollY == maxScrollY) ? 0 : extendedPaddingBottom);

    if (mShadowRadius != 0) {
      clipLeft += Math.min(0, mShadowDx - mShadowRadius);
      clipRight += Math.max(0, mShadowDx + mShadowRadius);

      clipTop += Math.min(0, mShadowDy - mShadowRadius);
      clipBottom += Math.max(0, mShadowDy + mShadowRadius);
    }

    canvas.clipRect(clipLeft, clipTop, clipRight, clipBottom);

    int voffsetText = 0;
    int voffsetCursor = 0;

    // translate in by our padding
    /* shortcircuit calling getVerticaOffset() */
    if ((mGravity & Gravity.VERTICAL_GRAVITY_MASK) != Gravity.TOP) {
      voffsetText = getVerticalOffset(false);
      voffsetCursor = getVerticalOffset(true);
    }
    canvas.translate(compoundPaddingLeft, extendedPaddingTop + voffsetText);

    final int layoutDirection = getLayoutDirection();
    final int absoluteGravity = Gravity.getAbsoluteGravity(mGravity, layoutDirection);
    if (isMarqueeFadeEnabled()) {
      if (!mSingleLine && getLineCount() == 1 && canMarquee()
          && (absoluteGravity & Gravity.HORIZONTAL_GRAVITY_MASK) != Gravity.LEFT) {
        final int width = mRight - mLeft;
        final int padding = getCompoundPaddingLeft() + getCompoundPaddingRight();
        final float dx = mLayout.getLineRight(0) - (width - padding);
        canvas.translate(layout.getParagraphDirection(0) * dx, 0.0f);
      }

      if (mMarquee != null && mMarquee.isRunning()) {
        final float dx = -mMarquee.getScroll();
        canvas.translate(layout.getParagraphDirection(0) * dx, 0.0f);
      }
    }

    final int cursorOffsetVertical = voffsetCursor - voffsetText;

    maybeUpdateHighlightPaths();
    // If there is a gesture preview highlight, then the selection or cursor is not drawn.
    Path highlight = hasGesturePreviewHighlight() ? null : getUpdatedHighlightPath();
    if (mEditor != null) {
      mEditor.onDraw(canvas, layout, mHighlightPaths, mHighlightPaints, highlight,
                     mHighlightPaint, cursorOffsetVertical);
    } else {
      layout.draw(canvas, mHighlightPaths, mHighlightPaints, highlight, mHighlightPaint,
                  cursorOffsetVertical);
    }

    if (mMarquee != null && mMarquee.shouldDrawGhost()) {
      final float dx = mMarquee.getGhostOffset();
      canvas.translate(layout.getParagraphDirection(0) * dx, 0.0f);
      layout.draw(canvas, mHighlightPaths, mHighlightPaints, highlight, mHighlightPaint,
                  cursorOffsetVertical);
    }

    canvas.restore();
  }

  @Override
  public void getFocusedRect(Rect r) {
    if (mLayout == null) {
      super.getFocusedRect(r);
      return;
    }

    int selEnd = getSelectionEndTransformed();
    if (selEnd < 0) {
      super.getFocusedRect(r);
      return;
    }

    int selStart = getSelectionStartTransformed();
    if (selStart < 0 || selStart >= selEnd) {
      int line = mLayout.getLineForOffset(selEnd);
      r.top = mLayout.getLineTop(line);
      r.bottom = mLayout.getLineBottom(line);
      r.left = (int) mLayout.getPrimaryHorizontal(selEnd) - 2;
      r.right = r.left + 4;
    } else {
      int lineStart = mLayout.getLineForOffset(selStart);
      int lineEnd = mLayout.getLineForOffset(selEnd);
      r.top = mLayout.getLineTop(lineStart);
      r.bottom = mLayout.getLineBottom(lineEnd);
      if (lineStart == lineEnd) {
        r.left = (int) mLayout.getPrimaryHorizontal(selStart);
        r.right = (int) mLayout.getPrimaryHorizontal(selEnd);
      } else {
        // Selection extends across multiple lines -- make the focused
        // rect cover the entire width.
        if (mHighlightPathBogus) {
          if (mHighlightPath == null) mHighlightPath = new Path();
          mHighlightPath.reset();
          mLayout.getSelectionPath(selStart, selEnd, mHighlightPath);
          mHighlightPathBogus = false;
        }
        synchronized (TEMP_RECTF) {
          mHighlightPath.computeBounds(TEMP_RECTF, true);
          r.left = (int) TEMP_RECTF.left - 1;
          r.right = (int) TEMP_RECTF.right + 1;
        }
      }
    }

    // Adjust for padding and gravity.
    int paddingLeft = getCompoundPaddingLeft();
    int paddingTop = getExtendedPaddingTop();
    if ((mGravity & Gravity.VERTICAL_GRAVITY_MASK) != Gravity.TOP) {
      paddingTop += getVerticalOffset(false);
    }
    r.offset(paddingLeft, paddingTop);
    int paddingBottom = getExtendedPaddingBottom();
    r.bottom += paddingBottom;
  }

  /**
   * Return the number of lines of text, or 0 if the internal Layout has not
   * been built.
   */
  public int getLineCount() {
    return mLayout != null ? mLayout.getLineCount() : 0;
  }

  /**
   * Return the baseline for the specified line (0...getLineCount() - 1)
   * If bounds is not null, return the top, left, right, bottom extents
   * of the specified line in it. If the internal Layout has not been built,
   * return 0 and set bounds to (0, 0, 0, 0)
   * @param line which line to examine (0..getLineCount() - 1)
   * @param bounds Optional. If not null, it returns the extent of the line
   * @return the Y-coordinate of the baseline
   */
  public int getLineBounds(int line, Rect bounds) {
    if (mLayout == null) {
      if (bounds != null) {
        bounds.set(0, 0, 0, 0);
      }
      return 0;
    } else {
      int baseline = mLayout.getLineBounds(line, bounds);

      int voffset = getExtendedPaddingTop();
      if ((mGravity & Gravity.VERTICAL_GRAVITY_MASK) != Gravity.TOP) {
        voffset += getVerticalOffset(true);
      }
      if (bounds != null) {
        bounds.offset(getCompoundPaddingLeft(), voffset);
      }
      return baseline + voffset;
    }
  }

  @Override
  public int getBaseline() {
    if (mLayout == null) {
      return super.getBaseline();
    }

    return getBaselineOffset() + mLayout.getLineBaseline(0);
  }

  int getBaselineOffset() {
    int voffset = 0;
    if ((mGravity & Gravity.VERTICAL_GRAVITY_MASK) != Gravity.TOP) {
      voffset = getVerticalOffset(true);
    }

    if (isLayoutModeOptical(mParent)) {
      voffset -= getOpticalInsets().top;
    }

    return getExtendedPaddingTop() + voffset;
  }

  /**
   * @hide
   */
  @Override
  protected int getFadeTop(boolean offsetRequired) {
    if (mLayout == null) return 0;

    int voffset = 0;
    if ((mGravity & Gravity.VERTICAL_GRAVITY_MASK) != Gravity.TOP) {
      voffset = getVerticalOffset(true);
    }

    if (offsetRequired) voffset += getTopPaddingOffset();

    return getExtendedPaddingTop() + voffset;
  }

  /**
   * @hide
   */
  @Override
  protected int getFadeHeight(boolean offsetRequired) {
    return mLayout != null ? mLayout.getHeight() : 0;
  }

  @Override
  public PointerIcon onResolvePointerIcon(MotionEvent event, int pointerIndex) {
    if (event.isFromSource(InputDevice.SOURCE_MOUSE)) {
      if (mSpannable != null && mLinksClickable) {
        final float x = event.getX(pointerIndex);
        final float y = event.getY(pointerIndex);
        final int offset = getOffsetForPosition(x, y);
        final ClickableSpan[] clickables = mSpannable.getSpans(offset, offset,
                                                               ClickableSpan.class);
        if (clickables.length > 0) {
          return PointerIcon.getSystemIcon(mContext, PointerIcon.TYPE_HAND);
        }
      }
      if (isTextSelectable() || isTextEditable()) {
        return PointerIcon.getSystemIcon(mContext, PointerIcon.TYPE_TEXT);
      }
    }
    return super.onResolvePointerIcon(event, pointerIndex);
  }

  @Override
  public boolean onKeyPreIme(int keyCode, KeyEvent event) {
    // Note: If the IME is in fullscreen mode and IMS#mExtractEditText is in text action mode,
    // InputMethodService#onKeyDown and InputMethodService#onKeyUp are responsible to call
    // InputMethodService#mExtractEditText.maybeHandleBackInTextActionMode(event).
    if (keyCode == KeyEvent.KEYCODE_BACK && handleBackInTextActionModeIfNeeded(event)) {
      return true;
    }
    return super.onKeyPreIme(keyCode, event);
  }

  /**
   * @hide
   */
  public boolean handleBackInTextActionModeIfNeeded(KeyEvent event) {
    // Do nothing unless mEditor is in text action mode.
    if (mEditor == null || mEditor.getTextActionMode() == null) {
      return false;
    }

    if (event.getAction() == KeyEvent.ACTION_DOWN && event.getRepeatCount() == 0) {
      KeyEvent.DispatcherState state = getKeyDispatcherState();
      if (state != null) {
        state.startTracking(event, this);
      }
      return true;
    } else if (event.getAction() == KeyEvent.ACTION_UP) {
      KeyEvent.DispatcherState state = getKeyDispatcherState();
      if (state != null) {
        state.handleUpEvent(event);
      }
      if (event.isTracking() && !event.isCanceled()) {
        stopTextActionMode();
        return true;
      }
    }
    return false;
  }

  @Override
  public boolean onKeyDown(int keyCode, KeyEvent event) {
    final int which = doKeyDown(keyCode, event, null);
    if (which == KEY_EVENT_NOT_HANDLED) {
      return super.onKeyDown(keyCode, event);
    }

    return true;
  }

  @Override
  public boolean onKeyMultiple(int keyCode, int repeatCount, KeyEvent event) {
    KeyEvent down = KeyEvent.changeAction(event, KeyEvent.ACTION_DOWN);
    final int which = doKeyDown(keyCode, down, event);
    if (which == KEY_EVENT_NOT_HANDLED) {
      // Go through default dispatching.
      return super.onKeyMultiple(keyCode, repeatCount, event);
    }
    if (which == KEY_EVENT_HANDLED) {
      // Consumed the whole thing.
      return true;
    }

    repeatCount--;

    // We are going to dispatch the remaining events to either the input
    // or movement method.  To do this, we will just send a repeated stream
    // of down and up events until we have done the complete repeatCount.
    // It would be nice if those interfaces had an onKeyMultiple() method,
    // but adding that is a more complicated change.
    KeyEvent up = KeyEvent.changeAction(event, KeyEvent.ACTION_UP);
    if (which == KEY_DOWN_HANDLED_BY_KEY_LISTENER) {
      // mEditor and mEditor.mInput are not null from doKeyDown
      mEditor.mKeyListener.onKeyUp(this, (Editable) mText, keyCode, up);
      while (--repeatCount > 0) {
        mEditor.mKeyListener.onKeyDown(this, (Editable) mText, keyCode, down);
        mEditor.mKeyListener.onKeyUp(this, (Editable) mText, keyCode, up);
      }
      hideErrorIfUnchanged();

    } else if (which == KEY_DOWN_HANDLED_BY_MOVEMENT_METHOD) {
      // mMovement is not null from doKeyDown
      mMovement.onKeyUp(this, mSpannable, keyCode, up);
      while (--repeatCount > 0) {
        mMovement.onKeyDown(this, mSpannable, keyCode, down);
        mMovement.onKeyUp(this, mSpannable, keyCode, up);
      }
    }

    return true;
  }

  /**
   * Returns true if pressing ENTER in this field advances focus instead
   * of inserting the character.  This is true mostly in single-line fields,
   * but also in mail addresses and subjects which will display on multiple
   * lines but where it doesn't make sense to insert newlines.
   */
  private boolean shouldAdvanceFocusOnEnter() {
    if (getKeyListener() == null) {
      return false;
    }

    if (mSingleLine) {
      return true;
    }

    if (mEditor != null
        && (mEditor.mInputType & EditorInfo.TYPE_MASK_CLASS)
           == EditorInfo.TYPE_CLASS_TEXT) {
      int variation = mEditor.mInputType & EditorInfo.TYPE_MASK_VARIATION;
      if (variation == EditorInfo.TYPE_TEXT_VARIATION_EMAIL_ADDRESS
          || variation == EditorInfo.TYPE_TEXT_VARIATION_EMAIL_SUBJECT) {
        return true;
      }
    }

    return false;
  }

  private boolean isDirectionalNavigationKey(int keyCode) {
    switch(keyCode) {
      case KeyEvent.KEYCODE_DPAD_UP:
      case KeyEvent.KEYCODE_DPAD_DOWN:
      case KeyEvent.KEYCODE_DPAD_LEFT:
      case KeyEvent.KEYCODE_DPAD_RIGHT:
        return true;
    }
    return false;
  }

  private int doKeyDown(int keyCode, KeyEvent event, KeyEvent otherEvent) {
    if (!isEnabled()) {
      return KEY_EVENT_NOT_HANDLED;
    }

    // If this is the initial keydown, we don't want to prevent a movement away from this view.
    // While this shouldn't be necessary because any time we're preventing default movement we
    // should be restricting the focus to remain within this view, thus we'll also receive
    // the key up event, occasionally key up events will get dropped and we don't want to
    // prevent the user from traversing out of this on the next key down.
    if (event.getRepeatCount() == 0 && !KeyEvent.isModifierKey(keyCode)) {
      mPreventDefaultMovement = false;
    }

    switch (keyCode) {
      case KeyEvent.KEYCODE_ENTER:
      case KeyEvent.KEYCODE_NUMPAD_ENTER:
        if (event.hasNoModifiers()) {
          // When mInputContentType is set, we know that we are
          // running in a "modern" cupcake environment, so don't need
          // to worry about the application trying to capture
          // enter key events.
          if (mEditor != null && mEditor.mInputContentType != null) {
            // If there is an action listener, given them a
            // chance to consume the event.
            if (mEditor.mInputContentType.onEditorActionListener != null
                && mEditor.mInputContentType.onEditorActionListener.onEditorAction(
              this,
              getActionIdForEnterEvent(),
              event)) {
              mEditor.mInputContentType.enterDown = true;
              // We are consuming the enter key for them.
              return KEY_EVENT_HANDLED;
            }
          }

          // If our editor should move focus when enter is pressed, or
          // this is a generated event from an IME action button, then
          // don't let it be inserted into the text.
          if ((event.getFlags() & KeyEvent.FLAG_EDITOR_ACTION) != 0
              || shouldAdvanceFocusOnEnter()) {
            if (hasOnClickListeners()) {
              return KEY_EVENT_NOT_HANDLED;
            }
            return KEY_EVENT_HANDLED;
          }
        }
        break;

      case KeyEvent.KEYCODE_DPAD_CENTER:
        if (event.hasNoModifiers()) {
          if (shouldAdvanceFocusOnEnter()) {
            return KEY_EVENT_NOT_HANDLED;
          }
        }
        break;

      case KeyEvent.KEYCODE_TAB:
        if (event.hasNoModifiers() || event.hasModifiers(KeyEvent.META_SHIFT_ON)) {
          // Tab is used to move focus.
          return KEY_EVENT_NOT_HANDLED;
        }
        break;

      // Has to be done on key down (and not on key up) to correctly be intercepted.
      case KeyEvent.KEYCODE_BACK:
        if (mEditor != null && mEditor.getTextActionMode() != null) {
          stopTextActionMode();
          return KEY_EVENT_HANDLED;
        }
        break;

      case KeyEvent.KEYCODE_ESCAPE:
        if (com.android.text.flags.Flags.escapeClearsFocus() && event.hasNoModifiers()) {
          if (mEditor != null && mEditor.getTextActionMode() != null) {
            stopTextActionMode();
            return KEY_EVENT_HANDLED;
          }
          if (hasFocus()) {
            clearFocus();
            InputMethodManager imm = getInputMethodManager();
            if (imm != null) {
              imm.hideSoftInputFromView(this, 0);
            }
            return KEY_EVENT_HANDLED;
          }
        }
        break;

      case KeyEvent.KEYCODE_CUT:
        if (event.hasNoModifiers() && canCut()) {
          if (onTextContextMenuItem(ID_CUT)) {
            return KEY_EVENT_HANDLED;
          }
        }
        break;

      case KeyEvent.KEYCODE_COPY:
        if (event.hasNoModifiers() && canCopy()) {
          if (onTextContextMenuItem(ID_COPY)) {
            return KEY_EVENT_HANDLED;
          }
        }
        break;

      case KeyEvent.KEYCODE_PASTE:
        if (event.hasNoModifiers() && canPaste()) {
          if (onTextContextMenuItem(ID_PASTE)) {
            return KEY_EVENT_HANDLED;
          }
        }
        break;

      case KeyEvent.KEYCODE_FORWARD_DEL:
        if (event.hasModifiers(KeyEvent.META_SHIFT_ON) && canCut()) {
          if (onTextContextMenuItem(ID_CUT)) {
            return KEY_EVENT_HANDLED;
          }
        }
        break;

      case KeyEvent.KEYCODE_INSERT:
        if (event.hasModifiers(KeyEvent.META_CTRL_ON) && canCopy()) {
          if (onTextContextMenuItem(ID_COPY)) {
            return KEY_EVENT_HANDLED;
          }
        } else if (event.hasModifiers(KeyEvent.META_SHIFT_ON) && canPaste()) {
          if (onTextContextMenuItem(ID_PASTE)) {
            return KEY_EVENT_HANDLED;
          }
        }
        break;
    }

    if (mEditor != null && mEditor.mKeyListener != null) {
      boolean doDown = true;
      if (otherEvent != null) {
        try {
          beginBatchEdit();
          final boolean handled = mEditor.mKeyListener.onKeyOther(this, (Editable) mText,
                                                                  otherEvent);
          hideErrorIfUnchanged();
          doDown = false;
          if (handled) {
            return KEY_EVENT_HANDLED;
          }
        } catch (AbstractMethodError e) {
          // onKeyOther was added after 1.0, so if it isn't
          // implemented we need to try to dispatch as a regular down.
        } finally {
          endBatchEdit();
        }
      }

      if (doDown) {
        beginBatchEdit();
        final boolean handled = mEditor.mKeyListener.onKeyDown(this, (Editable) mText,
                                                               keyCode, event);
        endBatchEdit();
        hideErrorIfUnchanged();
        if (handled) return KEY_DOWN_HANDLED_BY_KEY_LISTENER;
      }
    }

    // bug 650865: sometimes we get a key event before a layout.
    // don't try to move around if we don't know the layout.

    if (mMovement != null && mLayout != null) {
      boolean doDown = true;
      if (otherEvent != null) {
        try {
          boolean handled = mMovement.onKeyOther(this, mSpannable, otherEvent);
          doDown = false;
          if (handled) {
            return KEY_EVENT_HANDLED;
          }
        } catch (AbstractMethodError e) {
          // onKeyOther was added after 1.0, so if it isn't
          // implemented we need to try to dispatch as a regular down.
        }
      }
      if (doDown) {
        if (mMovement.onKeyDown(this, mSpannable, keyCode, event)) {
          if (event.getRepeatCount() == 0 && !KeyEvent.isModifierKey(keyCode)) {
            mPreventDefaultMovement = true;
          }
          return KEY_DOWN_HANDLED_BY_MOVEMENT_METHOD;
        }
      }
      // Consume arrows from keyboard devices to prevent focus leaving the editor.
      // DPAD/JOY devices (Gamepads, TV remotes) often lack a TAB key so allow those
      // to move focus with arrows.
      if (event.getSource() == InputDevice.SOURCE_KEYBOARD
          && isDirectionalNavigationKey(keyCode)) {
        return KEY_EVENT_HANDLED;
      }
    }

    return mPreventDefaultMovement && !KeyEvent.isModifierKey(keyCode)
           ? KEY_EVENT_HANDLED : KEY_EVENT_NOT_HANDLED;
  }

  /**
   * Resets the mErrorWasChanged flag, so that future calls to {@link #setError(CharSequence)}
   * can be recorded.
   * @hide
   */
  public void resetErrorChangedFlag() {
    /*
     * Keep track of what the error was before doing the input
     * so that if an input filter changed the error, we leave
     * that error showing.  Otherwise, we take down whatever
     * error was showing when the user types something.
     */
    if (mEditor != null) mEditor.mErrorWasChanged = false;
  }

  /**
   * @hide
   */
  public void hideErrorIfUnchanged() {
    if (mEditor != null && mEditor.mError != null && !mEditor.mErrorWasChanged) {
      setError(null, null);
    }
  }

  @Override
  public boolean onKeyUp(int keyCode, KeyEvent event) {
    if (!isEnabled()) {
      return super.onKeyUp(keyCode, event);
    }

    if (!KeyEvent.isModifierKey(keyCode)) {
      mPreventDefaultMovement = false;
    }

    switch (keyCode) {
      case KeyEvent.KEYCODE_DPAD_CENTER:
        if (event.hasNoModifiers()) {
          /*
           * If there is a click listener, just call through to
           * super, which will invoke it.
           *
           * If there isn't a click listener, try to show the soft
           * input method.  (It will also
           * call performClick(), but that won't do anything in
           * this case.)
           */
          if (!hasOnClickListeners()) {
            if (mMovement != null && mText instanceof Editable
                && mLayout != null && onCheckIsTextEditor()) {
              InputMethodManager imm = getInputMethodManager();
              viewClicked(imm);
              if (imm != null && getShowSoftInputOnFocus()) {
                imm.showSoftInput(this, 0);
              }
            }
          }
        }
        return super.onKeyUp(keyCode, event);

      case KeyEvent.KEYCODE_ENTER:
      case KeyEvent.KEYCODE_NUMPAD_ENTER:
        if (event.hasNoModifiers()) {
          if (mEditor != null && mEditor.mInputContentType != null
              && mEditor.mInputContentType.onEditorActionListener != null
              && mEditor.mInputContentType.enterDown) {
            mEditor.mInputContentType.enterDown = false;
            if (mEditor.mInputContentType.onEditorActionListener.onEditorAction(
              this, getActionIdForEnterEvent(), event)) {
              return true;
            }
          }

          if ((event.getFlags() & KeyEvent.FLAG_EDITOR_ACTION) != 0
              || shouldAdvanceFocusOnEnter()) {
            /*
             * If there is a click listener, just call through to
             * super, which will invoke it.
             *
             * If there isn't a click listener, try to advance focus,
             * but still call through to super, which will reset the
             * pressed state and longpress state.  (It will also
             * call performClick(), but that won't do anything in
             * this case.)
             */
            if (!hasOnClickListeners()) {
              View v = focusSearch(FOCUS_DOWN);

              if (v != null) {
                if (!v.requestFocus(FOCUS_DOWN)) {
                  throw new IllegalStateException("focus search returned a view "
                                                  + "that wasn't able to take focus!");
                }

                /*
                 * Return true because we handled the key; super
                 * will return false because there was no click
                 * listener.
                 */
                super.onKeyUp(keyCode, event);
                return true;
              } else if ((event.getFlags()
                          & KeyEvent.FLAG_EDITOR_ACTION) != 0) {
                // No target for next focus, but make sure the IME
                // if this came from it.
                InputMethodManager imm = getInputMethodManager();
                if (imm != null) {
                  imm.hideSoftInputFromView(this, 0);
                }
              }
            }
          }
          return super.onKeyUp(keyCode, event);
        }
        break;
    }

    if (mEditor != null && mEditor.mKeyListener != null) {
      if (mEditor.mKeyListener.onKeyUp(this, (Editable) mText, keyCode, event)) {
        return true;
      }
    }

    if (mMovement != null && mLayout != null) {
      if (mMovement.onKeyUp(this, mSpannable, keyCode, event)) {
        return true;
      }
    }

    return super.onKeyUp(keyCode, event);
  }

  private int getActionIdForEnterEvent() {
    // If it's not single line, no action
    if (!isSingleLine()) {
      return EditorInfo.IME_NULL;
    }
    // Return the action that was specified for Enter
    return getImeOptions() & EditorInfo.IME_MASK_ACTION;
  }

  @Override
  public boolean onCheckIsTextEditor() {
    return mEditor != null && mEditor.mInputType != EditorInfo.TYPE_NULL;
  }

  private boolean hasEditorInFocusSearchDirection(@FocusRealDirection int direction) {
    final View nextView = focusSearch(direction);
    return nextView != null && nextView.onCheckIsTextEditor();
  }

  @Override
  public InputConnection onCreateInputConnection(EditorInfo outAttrs) {
    if (onCheckIsTextEditor() && isEnabled()) {
      mEditor.createInputMethodStateIfNeeded();
      mEditor.mInputMethodState.mUpdateCursorAnchorInfoMode = 0;
      mEditor.mInputMethodState.mUpdateCursorAnchorInfoFilter = 0;

      outAttrs.inputType = getInputType();
      if (mEditor.mInputContentType != null) {
        outAttrs.imeOptions = mEditor.mInputContentType.imeOptions;
        outAttrs.privateImeOptions = mEditor.mInputContentType.privateImeOptions;
        outAttrs.actionLabel = mEditor.mInputContentType.imeActionLabel;
        outAttrs.actionId = mEditor.mInputContentType.imeActionId;
        outAttrs.extras = mEditor.mInputContentType.extras;
        outAttrs.hintLocales = mEditor.mInputContentType.imeHintLocales;
      } else {
        outAttrs.imeOptions = EditorInfo.IME_NULL;
        outAttrs.hintLocales = null;
      }
      if (hasEditorInFocusSearchDirection(FOCUS_DOWN)) {
        outAttrs.imeOptions |= EditorInfo.IME_FLAG_NAVIGATE_NEXT;
      }
      if (hasEditorInFocusSearchDirection(FOCUS_UP)) {
        outAttrs.imeOptions |= EditorInfo.IME_FLAG_NAVIGATE_PREVIOUS;
      }
      if ((outAttrs.imeOptions & EditorInfo.IME_MASK_ACTION)
          == EditorInfo.IME_ACTION_UNSPECIFIED) {
        if ((outAttrs.imeOptions & EditorInfo.IME_FLAG_NAVIGATE_NEXT) != 0) {
          // An action has not been set, but the enter key will move to
          // the next focus, so set the action to that.
          outAttrs.imeOptions |= EditorInfo.IME_ACTION_NEXT;
        } else {
          // An action has not been set, and there is no focus to move
          // to, so let's just supply a "done" action.
          outAttrs.imeOptions |= EditorInfo.IME_ACTION_DONE;
        }
        if (!shouldAdvanceFocusOnEnter()) {
          outAttrs.imeOptions |= EditorInfo.IME_FLAG_NO_ENTER_ACTION;
        }
      }
      if (getResources().getConfiguration().orientation == ORIENTATION_PORTRAIT) {
        outAttrs.internalImeOptions |= EditorInfo.IME_INTERNAL_FLAG_APP_WINDOW_PORTRAIT;
      }
      if (isMultilineInputType(outAttrs.inputType)) {
        // Multi-line text editors should always show an enter key.
        outAttrs.imeOptions |= EditorInfo.IME_FLAG_NO_ENTER_ACTION;
      }
      outAttrs.hintText = mHint;
      outAttrs.targetInputMethodUser = mTextOperationUser;
      if (mText instanceof Editable) {
        InputConnection ic = new EditableInputConnection(this);
        outAttrs.initialSelStart = getSelectionStart();
        outAttrs.initialSelEnd = getSelectionEnd();
        outAttrs.initialCapsMode = ic.getCursorCapsMode(getInputType());
        outAttrs.setInitialSurroundingText(mText);
        outAttrs.contentMimeTypes = getReceiveContentMimeTypes();
        if (android.view.inputmethod.Flags.editorinfoHandwritingEnabled()
            && isAutoHandwritingEnabled()) {
          outAttrs.setStylusHandwritingEnabled(true);
        }
        ArrayList<Class<? extends HandwritingGesture>> gestures = new ArrayList<>();
        gestures.add(SelectGesture.class);
        gestures.add(SelectRangeGesture.class);
        gestures.add(DeleteGesture.class);
        gestures.add(DeleteRangeGesture.class);
        gestures.add(InsertGesture.class);
        gestures.add(RemoveSpaceGesture.class);
        gestures.add(JoinOrSplitGesture.class);
        gestures.add(InsertModeGesture.class);
        outAttrs.setSupportedHandwritingGestures(gestures);

        Set<Class<? extends PreviewableHandwritingGesture>> previews = new ArraySet<>();
        previews.add(SelectGesture.class);
        previews.add(SelectRangeGesture.class);
        previews.add(DeleteGesture.class);
        previews.add(DeleteRangeGesture.class);
        outAttrs.setSupportedHandwritingGesturePreviews(previews);

        return ic;
      }
    }
    return null;
  }

  /**
   * Called back by the system to handle {@link InputConnection#requestCursorUpdates(int, int)}.
   *
   * @param cursorUpdateMode modes defined in {@link InputConnection.CursorUpdateMode}.
   * @param cursorUpdateFilter modes defined in {@link InputConnection.CursorUpdateFilter}.
   *
   * @hide
   */
  public void onRequestCursorUpdatesInternal(
    @InputConnection.CursorUpdateMode int cursorUpdateMode,
    @InputConnection.CursorUpdateFilter int cursorUpdateFilter) {
    mEditor.mInputMethodState.mUpdateCursorAnchorInfoMode = cursorUpdateMode;
    mEditor.mInputMethodState.mUpdateCursorAnchorInfoFilter = cursorUpdateFilter;
    if ((cursorUpdateMode & InputConnection.CURSOR_UPDATE_IMMEDIATE) == 0) {
      return;
    }
    if (isInLayout()) {
      // In this case, the view hierarchy is currently undergoing a layout pass.
      // IMM#updateCursorAnchorInfo is supposed to be called soon after the layout
      // pass is finished.
    } else {
      // This will schedule a layout pass of the view tree, and the layout event
      // eventually triggers IMM#updateCursorAnchorInfo.
      requestLayout();
    }
  }

  /**
   * If this TextView contains editable content, extract a portion of it
   * based on the information in <var>request</var> in to <var>outText</var>.
   * @return Returns true if the text was successfully extracted, else false.
   */
  public boolean extractText(ExtractedTextRequest request, ExtractedText outText) {
    createEditorIfNeeded();
    return mEditor.extractText(request, outText);
  }

  /**
   * This is used to remove all style-impacting spans from text before new
   * extracted text is being replaced into it, so that we don't have any
   * lingering spans applied during the replace.
   */
  static void removeParcelableSpans(Spannable spannable, int start, int end) {
    Object[] spans = spannable.getSpans(start, end, ParcelableSpan.class);
    int i = spans.length;
    while (i > 0) {
      i--;
      spannable.removeSpan(spans[i]);
    }
  }

  /**
   * Apply to this text view the given extracted text, as previously
   * returned by {@link #extractText(ExtractedTextRequest, ExtractedText)}.
   */
  public void setExtractedText(ExtractedText text) {
    Editable content = getEditableText();
    if (text.text != null) {
      if (content == null) {
        setText(text.text, TextView.BufferType.EDITABLE);
      } else {
        int start = 0;
        int end = content.length();

        if (text.partialStartOffset >= 0) {
          final int N = content.length();
          start = text.partialStartOffset;
          if (start > N) start = N;
          end = text.partialEndOffset;
          if (end > N) end = N;
        }

        removeParcelableSpans(content, start, end);
        if (TextUtils.equals(content.subSequence(start, end), text.text)) {
          if (text.text instanceof Spanned) {
            // OK to copy spans only.
            TextUtils.copySpansFrom((Spanned) text.text, 0, end - start,
                                    Object.class, content, start);
          }
        } else {
          content.replace(start, end, text.text);
        }
      }
    }

    // Now set the selection position...  make sure it is in range, to
    // avoid crashes.  If this is a partial update, it is possible that
    // the underlying text may have changed, causing us problems here.
    // Also we just don't want to trust clients to do the right thing.
    Spannable sp = (Spannable) getText();
    final int N = sp.length();
    int start = text.selectionStart;
    if (start < 0) {
      start = 0;
    } else if (start > N) {
      start = N;
    }
    int end = text.selectionEnd;
    if (end < 0) {
      end = 0;
    } else if (end > N) {
      end = N;
    }
    Selection.setSelection(sp, start, end);

    // Finally, update the selection mode.
    if ((text.flags & ExtractedText.FLAG_SELECTING) != 0) {
      MetaKeyKeyListener.startSelecting(this, sp);
    } else {
      MetaKeyKeyListener.stopSelecting(this, sp);
    }

    setHintInternal(text.hint);
  }

  /**
   * @hide
   */
  public void setExtracting(ExtractedTextRequest req) {
    if (mEditor.mInputMethodState != null) {
      mEditor.mInputMethodState.mExtractedTextRequest = req;
    }
    // This would stop a possible selection mode, but no such mode is started in case
    // extracted mode will start. Some text is selected though, and will trigger an action mode
    // in the extracted view.
    mEditor.hideCursorAndSpanControllers();
    stopTextActionMode();
    if (mEditor.mSelectionModifierCursorController != null) {
      mEditor.mSelectionModifierCursorController.resetTouchOffsets();
    }
  }

  /**
   * Called by the framework in response to a text completion from
   * the current input method, provided by it calling
   * {@link InputConnection#commitCompletion
   * InputConnection.commitCompletion()}.  The default implementation does
   * nothing; text views that are supporting auto-completion should override
   * this to do their desired behavior.
   *
   * @param text The auto complete text the user has selected.
   */
  public void onCommitCompletion(CompletionInfo text) {
    // intentionally empty
  }

  /**
   * Called by the framework in response to a text auto-correction (such as fixing a typo using a
   * dictionary) from the current input method, provided by it calling
   * {@link InputConnection#commitCorrection(CorrectionInfo) InputConnection.commitCorrection()}.
   * The default implementation flashes the background of the corrected word to provide
   * feedback to the user.
   *
   * @param info The auto correct info about the text that was corrected.
   */
  public void onCommitCorrection(CorrectionInfo info) {
    if (mEditor != null) mEditor.onCommitCorrection(info);
  }

  public void beginBatchEdit() {
    if (mEditor != null) mEditor.beginBatchEdit();
  }

  public void endBatchEdit() {
    if (mEditor != null) mEditor.endBatchEdit();
  }

  /**
   * Called by the framework in response to a request to begin a batch
   * of edit operations through a call to link {@link #beginBatchEdit()}.
   */
  public void onBeginBatchEdit() {
    // intentionally empty
  }

  /**
   * Called by the framework in response to a request to end a batch
   * of edit operations through a call to link {@link #endBatchEdit}.
   */
  public void onEndBatchEdit() {
    // intentionally empty
  }

  /** @hide */
  public void onPerformSpellCheck() {
    if (mEditor != null && mEditor.mSpellChecker != null) {
      mEditor.mSpellChecker.onPerformSpellCheck();
    }
  }

  /**
   * Called by the framework in response to a private command from the
   * current method, provided by it calling
   * {@link InputConnection#performPrivateCommand
   * InputConnection.performPrivateCommand()}.
   *
   * @param action The action name of the command.
   * @param data Any additional data for the command.  This may be null.
   * @return Return true if you handled the command, else false.
   */
  public boolean onPrivateIMECommand(String action, Bundle data) {
    return false;
  }

  /**
   * Return whether the text is transformed and has {@link OffsetMapping}.
   * @hide
   */
  public boolean isOffsetMappingAvailable() {
    return mTransformation != null && mTransformed instanceof OffsetMapping;
  }

  /** @hide */
  public boolean previewHandwritingGesture(
    @NonNull PreviewableHandwritingGesture gesture,
    @Nullable CancellationSignal cancellationSignal) {
    if (gesture instanceof SelectGesture) {
      performHandwritingSelectGesture((SelectGesture) gesture, /* isPreview= */ true);
    } else if (gesture instanceof SelectRangeGesture) {
      performHandwritingSelectRangeGesture(
        (SelectRangeGesture) gesture, /* isPreview= */ true);
    } else if (gesture instanceof DeleteGesture) {
      performHandwritingDeleteGesture((DeleteGesture) gesture, /* isPreview= */ true);
    } else if (gesture instanceof DeleteRangeGesture) {
      performHandwritingDeleteRangeGesture(
        (DeleteRangeGesture) gesture, /* isPreview= */ true);
    } else {
      return false;
    }
    if (cancellationSignal != null) {
      cancellationSignal.setOnCancelListener(this::clearGesturePreviewHighlight);
    }
    return true;
  }

  /** @hide */
  public int performHandwritingSelectGesture(@NonNull SelectGesture gesture) {
    return performHandwritingSelectGesture(gesture, /* isPreview= */ false);
  }

  private int performHandwritingSelectGesture(@NonNull SelectGesture gesture, boolean isPreview) {
    if (isOffsetMappingAvailable()) {
      return InputConnection.HANDWRITING_GESTURE_RESULT_FAILED;
    }
    int[] range = getRangeForRect(
      convertFromScreenToContentCoordinates(gesture.getSelectionArea()),
      gesture.getGranularity());
    if (range == null) {
      return handleGestureFailure(gesture, isPreview);
    }
    return performHandwritingSelectGesture(range, isPreview);
  }

  private int performHandwritingSelectGesture(int[] range, boolean isPreview) {
    if (isPreview) {
      setSelectGesturePreviewHighlight(range[0], range[1]);
    } else {
      Selection.setSelection(getEditableText(), range[0], range[1]);
      mEditor.startSelectionActionModeAsync(/* adjustSelection= */ false);
    }
    return InputConnection.HANDWRITING_GESTURE_RESULT_SUCCESS;
  }

  /** @hide */
  public int performHandwritingSelectRangeGesture(@NonNull SelectRangeGesture gesture) {
    return performHandwritingSelectRangeGesture(gesture, /* isPreview= */ false);
  }

  private int performHandwritingSelectRangeGesture(
    @NonNull SelectRangeGesture gesture, boolean isPreview) {
    if (isOffsetMappingAvailable()) {
      return InputConnection.HANDWRITING_GESTURE_RESULT_FAILED;
    }
    int[] startRange = getRangeForRect(
      convertFromScreenToContentCoordinates(gesture.getSelectionStartArea()),
      gesture.getGranularity());
    if (startRange == null) {
      return handleGestureFailure(gesture, isPreview);
    }
    int[] endRange = getRangeForRect(
      convertFromScreenToContentCoordinates(gesture.getSelectionEndArea()),
      gesture.getGranularity());
    if (endRange == null) {
      return handleGestureFailure(gesture, isPreview);
    }
    int[] range = new int[] {
      Math.min(startRange[0], endRange[0]), Math.max(startRange[1], endRange[1])
    };
    return performHandwritingSelectGesture(range, isPreview);
  }

  /** @hide */
  public int performHandwritingDeleteGesture(@NonNull DeleteGesture gesture) {
    return performHandwritingDeleteGesture(gesture, /* isPreview= */ false);
  }

  private int performHandwritingDeleteGesture(@NonNull DeleteGesture gesture, boolean isPreview) {
    if (isOffsetMappingAvailable()) {
      return InputConnection.HANDWRITING_GESTURE_RESULT_FAILED;
    }
    int[] range = getRangeForRect(
      convertFromScreenToContentCoordinates(gesture.getDeletionArea()),
      gesture.getGranularity());
    if (range == null) {
      return handleGestureFailure(gesture, isPreview);
    }
    return performHandwritingDeleteGesture(range, gesture.getGranularity(), isPreview);
  }

  private int performHandwritingDeleteGesture(int[] range, int granularity, boolean isPreview) {
    if (isPreview) {
      setDeleteGesturePreviewHighlight(range[0], range[1]);
    } else {
      if (granularity == HandwritingGesture.GRANULARITY_WORD) {
        range = adjustHandwritingDeleteGestureRange(range);
      }

      Selection.setSelection(getEditableText(), range[0]);
      getEditableText().delete(range[0], range[1]);
    }
    return InputConnection.HANDWRITING_GESTURE_RESULT_SUCCESS;
  }

  /** @hide */
  public int performHandwritingDeleteRangeGesture(@NonNull DeleteRangeGesture gesture) {
    return performHandwritingDeleteRangeGesture(gesture, /* isPreview= */ false);
  }

  private int performHandwritingDeleteRangeGesture(
    @NonNull DeleteRangeGesture gesture, boolean isPreview) {
    if (isOffsetMappingAvailable()) {
      return InputConnection.HANDWRITING_GESTURE_RESULT_FAILED;
    }
    int[] startRange = getRangeForRect(
      convertFromScreenToContentCoordinates(gesture.getDeletionStartArea()),
      gesture.getGranularity());
    if (startRange == null) {
      return handleGestureFailure(gesture, isPreview);
    }
    int[] endRange = getRangeForRect(
      convertFromScreenToContentCoordinates(gesture.getDeletionEndArea()),
      gesture.getGranularity());
    if (endRange == null) {
      return handleGestureFailure(gesture, isPreview);
    }
    int[] range = new int[] {
      Math.min(startRange[0], endRange[0]), Math.max(startRange[1], endRange[1])
    };
    return performHandwritingDeleteGesture(range, gesture.getGranularity(), isPreview);
  }

  private int[] adjustHandwritingDeleteGestureRange(int[] range) {
    // For handwriting delete gestures with word granularity, adjust the start and end offsets
    // to remove extra whitespace around the deleted text.

    int start = range[0];
    int end = range[1];

    // If the deleted text is at the start of the text, the behavior is the same as the case
    // where the deleted text follows a new line character.
    int codePointBeforeStart = start > 0
                               ? Character.codePointBefore(mText, start) : TextUtils.LINE_FEED_CODE_POINT;
    // If the deleted text is at the end of the text, the behavior is the same as the case where
    // the deleted text precedes a new line character.
    int codePointAtEnd = end < mText.length()
                         ? Character.codePointAt(mText, end) : TextUtils.LINE_FEED_CODE_POINT;

    if (TextUtils.isWhitespaceExceptNewline(codePointBeforeStart)
        && (TextUtils.isWhitespace(codePointAtEnd)
            || TextUtils.isPunctuation(codePointAtEnd))) {
      // Remove whitespace (except new lines) before the deleted text, in these cases:
      // - There is whitespace following the deleted text
      //     e.g. "one [deleted] three" -> "one | three" -> "one| three"
      // - There is punctuation following the deleted text
      //     e.g. "one [deleted]!" -> "one |!" -> "one|!"
      // - There is a new line following the deleted text
      //     e.g. "one [deleted]\n" -> "one |\n" -> "one|\n"
      // - The deleted text is at the end of the text
      //     e.g. "one [deleted]" -> "one |" -> "one|"
      // (The pipe | indicates the cursor position.)
      do {
        start -= Character.charCount(codePointBeforeStart);
        if (start == 0) break;
        codePointBeforeStart = Character.codePointBefore(mText, start);
      } while (TextUtils.isWhitespaceExceptNewline(codePointBeforeStart));
      return new int[] {start, end};
    }

    if (TextUtils.isWhitespaceExceptNewline(codePointAtEnd)
        && (TextUtils.isWhitespace(codePointBeforeStart)
            || TextUtils.isPunctuation(codePointBeforeStart))) {
      // Remove whitespace (except new lines) after the deleted text, in these cases:
      // - There is punctuation preceding the deleted text
      //     e.g. "([deleted] two)" -> "(| two)" -> "(|two)"
      // - There is a new line preceding the deleted text
      //     e.g. "\n[deleted] two" -> "\n| two" -> "\n|two"
      // - The deleted text is at the start of the text
      //     e.g. "[deleted] two" -> "| two" -> "|two"
      // (The pipe | indicates the cursor position.)
      do {
        end += Character.charCount(codePointAtEnd);
        if (end == mText.length()) break;
        codePointAtEnd = Character.codePointAt(mText, end);
      } while (TextUtils.isWhitespaceExceptNewline(codePointAtEnd));
      return new int[] {start, end};
    }

    // Return the original range.
    return range;
  }

  /** @hide */
  public int performHandwritingInsertGesture(@NonNull InsertGesture gesture) {
    if (isOffsetMappingAvailable()) {
      return InputConnection.HANDWRITING_GESTURE_RESULT_FAILED;
    }
    PointF point = convertFromScreenToContentCoordinates(gesture.getInsertionPoint());
    int line = getLineForHandwritingGesture(point);
    if (line == -1) {
      return handleGestureFailure(gesture);
    }
    int offset = mLayout.getOffsetForHorizontal(line, point.x);
    String textToInsert = gesture.getTextToInsert();
    return tryInsertTextForHandwritingGesture(offset, textToInsert, gesture);
    // TODO(b/243980426): Insert extra spaces if necessary.
  }

  /** @hide */
  public int performHandwritingRemoveSpaceGesture(@NonNull RemoveSpaceGesture gesture) {
    if (isOffsetMappingAvailable()) {
      return InputConnection.HANDWRITING_GESTURE_RESULT_FAILED;
    }
    PointF startPoint = convertFromScreenToContentCoordinates(gesture.getStartPoint());
    PointF endPoint = convertFromScreenToContentCoordinates(gesture.getEndPoint());

    // The operation should be applied to the first line of text containing one of the points.
    int startPointLine = getLineForHandwritingGesture(startPoint);
    int endPointLine = getLineForHandwritingGesture(endPoint);
    int line;
    if (startPointLine == -1) {
      if (endPointLine == -1) {
        return handleGestureFailure(gesture);
      }
      line = endPointLine;
    } else {
      line = (endPointLine == -1) ? startPointLine : Math.min(startPointLine, endPointLine);
    }

    // The operation should be applied to all characters touched by the line joining the points.
    float lineVerticalCenter = (mLayout.getLineTop(line)
                                + mLayout.getLineBottom(line, /* includeLineSpacing= */ false)) / 2f;
    // Create a rectangle which is +/-0.1f around the line's vertical center, so that the
    // rectangle doesn't touch the line above or below. (The line height is at least 1f.)
    RectF area = new RectF(
      Math.min(startPoint.x, endPoint.x),
      lineVerticalCenter + 0.1f,
      Math.max(startPoint.x, endPoint.x),
      lineVerticalCenter - 0.1f);
    int[] range = mLayout.getRangeForRect(
      area, new GraphemeClusterSegmentFinder(mText, mTextPaint),
      Layout.INCLUSION_STRATEGY_ANY_OVERLAP);
    if (range == null) {
      return handleGestureFailure(gesture);
    }
    int startOffset = range[0];
    int endOffset = range[1];
    // TODO(b/247557062): This doesn't handle bidirectional text correctly.

    Pattern whitespacePattern = getWhitespacePattern();
    Matcher matcher = whitespacePattern.matcher(mText.subSequence(startOffset, endOffset));
    int lastRemoveOffset = -1;
    while (matcher.find()) {
      lastRemoveOffset = startOffset + matcher.start();
      getEditableText().delete(lastRemoveOffset, startOffset + matcher.end());
      startOffset = lastRemoveOffset;
      endOffset -= matcher.end() - matcher.start();
      if (startOffset == endOffset) {
        break;
      }
      matcher = whitespacePattern.matcher(mText.subSequence(startOffset, endOffset));
    }
    if (lastRemoveOffset == -1) {
      return handleGestureFailure(gesture);
    }
    Selection.setSelection(getEditableText(), lastRemoveOffset);
    return InputConnection.HANDWRITING_GESTURE_RESULT_SUCCESS;
  }

  /** @hide */
  public int performHandwritingJoinOrSplitGesture(@NonNull JoinOrSplitGesture gesture) {
    if (isOffsetMappingAvailable()) {
      return InputConnection.HANDWRITING_GESTURE_RESULT_FAILED;
    }
    PointF point = convertFromScreenToContentCoordinates(gesture.getJoinOrSplitPoint());

    int line = getLineForHandwritingGesture(point);
    if (line == -1) {
      return handleGestureFailure(gesture);
    }

    int startOffset = mLayout.getOffsetForHorizontal(line, point.x);
    if (mLayout.isLevelBoundary(startOffset)) {
      // TODO(b/247551937): Support gesture at level boundaries.
      return handleGestureFailure(gesture);
    }

    int endOffset = startOffset;
    while (startOffset > 0) {
      int codePointBeforeStart = Character.codePointBefore(mText, startOffset);
      if (!TextUtils.isWhitespace(codePointBeforeStart)) {
        break;
      }
      startOffset -= Character.charCount(codePointBeforeStart);
    }
    while (endOffset < mText.length()) {
      int codePointAtEnd = Character.codePointAt(mText, endOffset);
      if (!TextUtils.isWhitespace(codePointAtEnd)) {
        break;
      }
      endOffset += Character.charCount(codePointAtEnd);
    }
    if (startOffset < endOffset) {
      Selection.setSelection(getEditableText(), startOffset);
      getEditableText().delete(startOffset, endOffset);
      return InputConnection.HANDWRITING_GESTURE_RESULT_SUCCESS;
    } else {
      // No whitespace found, so insert a space.
      return tryInsertTextForHandwritingGesture(startOffset, " ", gesture);
    }
  }

  /** @hide */
  public int performHandwritingInsertModeGesture(@NonNull InsertModeGesture gesture) {
    final PointF insertPoint =
      convertFromScreenToContentCoordinates(gesture.getInsertionPoint());
    final int line = getLineForHandwritingGesture(insertPoint);
    final CancellationSignal cancellationSignal = gesture.getCancellationSignal();

    // If no cancellationSignal is provided, don't enter the insert mode.
    if (line == -1 || cancellationSignal == null) {
      return handleGestureFailure(gesture);
    }

    final int offset = mLayout.getOffsetForHorizontal(line, insertPoint.x);

    if (!mEditor.enterInsertMode(offset)) {
      return InputConnection.HANDWRITING_GESTURE_RESULT_FAILED;
    }
    cancellationSignal.setOnCancelListener(() -> mEditor.exitInsertMode());
    return InputConnection.HANDWRITING_GESTURE_RESULT_SUCCESS;
  }

  private int handleGestureFailure(HandwritingGesture gesture) {
    return handleGestureFailure(gesture, /* isPreview= */ false);
  }

  private int handleGestureFailure(HandwritingGesture gesture, boolean isPreview) {
    clearGesturePreviewHighlight();
    if (!isPreview && !TextUtils.isEmpty(gesture.getFallbackText())) {
      getEditableText()
        .replace(getSelectionStart(), getSelectionEnd(), gesture.getFallbackText());
      return InputConnection.HANDWRITING_GESTURE_RESULT_FALLBACK;
    }
    return InputConnection.HANDWRITING_GESTURE_RESULT_FAILED;
  }

  /**
   * Returns the closest line such that the point is either inside the line bounds or within
   * {@link ViewConfiguration#getScaledHandwritingGestureLineMargin} of the line bounds. Returns
   * -1 if the point is not within the margin of any line bounds.
   */
  private int getLineForHandwritingGesture(PointF point) {
    int line = mLayout.getLineForVertical((int) point.y);
    int lineMargin = ViewConfiguration.get(mContext).getScaledHandwritingGestureLineMargin();
    if (line < mLayout.getLineCount() - 1
        && point.y > mLayout.getLineBottom(line) - lineMargin
        && point.y
           > (mLayout.getLineBottom(line, false) + mLayout.getLineBottom(line)) / 2f) {
      // If a point is in the space between line i and line (i + 1), Layout#getLineForVertical
      // returns i. If the point is within lineMargin of line (i + 1), and closer to line
      // (i + 1) than line i, then the gesture operation should be applied to line (i + 1).
      line++;
    } else if (point.y < mLayout.getLineTop(line) - lineMargin
               || point.y
                  > mLayout.getLineBottom(line, /* includeLineSpacing= */ false)
                    + lineMargin) {
      // The point is not within lineMargin of a line.
      return -1;
    }
    if (point.x < -lineMargin || point.x > mLayout.getWidth() + lineMargin) {
      // The point is not within lineMargin of a line.
      return -1;
    }
    return line;
  }

  @Nullable
  private int[] getRangeForRect(@NonNull RectF area, int granularity) {
    SegmentFinder segmentFinder;
    if (granularity == HandwritingGesture.GRANULARITY_WORD) {
      WordIterator wordIterator = getWordIterator();
      wordIterator.setCharSequence(mText, 0, mText.length());
      segmentFinder = new WordSegmentFinder(mText, wordIterator);
    } else {
      segmentFinder = new GraphemeClusterSegmentFinder(mText, mTextPaint);
    }

    return mLayout.getRangeForRect(
      area, segmentFinder, Layout.INCLUSION_STRATEGY_CONTAINS_CENTER);
  }

  private int tryInsertTextForHandwritingGesture(
    int offset, String textToInsert, HandwritingGesture gesture) {
    // A temporary cursor span is placed at the insertion offset. The span will be pushed
    // forward when text is inserted, then the real cursor can be placed after the inserted
    // text. A temporary cursor span is used in order to avoid modifying the real selection span
    // in the case that the text is filtered out.
    Editable editableText = getEditableText();
    if (mTempCursor == null) {
      mTempCursor = new NoCopySpan.Concrete();
    }
    editableText.setSpan(mTempCursor, offset, offset, Spanned.SPAN_POINT_POINT);

    editableText.insert(offset, textToInsert);

    int newOffset = editableText.getSpanStart(mTempCursor);
    editableText.removeSpan(mTempCursor);
    if (newOffset == offset) {
      // The inserted text was filtered out.
      return handleGestureFailure(gesture);
    } else {
      // Place the cursor after the inserted text.
      Selection.setSelection(editableText, newOffset);
      return InputConnection.HANDWRITING_GESTURE_RESULT_SUCCESS;
    }
  }

  private Pattern getWhitespacePattern() {
    if (mWhitespacePattern == null) {
      mWhitespacePattern = Pattern.compile("\\s+");
    }
    return mWhitespacePattern;
  }

  /** @hide */
  @VisibleForTesting
  @UnsupportedAppUsage
  public void nullLayouts() {
    if (mLayout instanceof BoringLayout && mSavedLayout == null) {
      mSavedLayout = (BoringLayout) mLayout;
    }
    if (mHintLayout instanceof BoringLayout && mSavedHintLayout == null) {
      mSavedHintLayout = (BoringLayout) mHintLayout;
    }

    mSavedMarqueeModeLayout = mLayout = mHintLayout = null;

    mBoring = mHintBoring = null;

    // Since it depends on the value of mLayout
    if (mEditor != null) mEditor.prepareCursorControllers();
  }

  /**
   * Make a new Layout based on the already-measured size of the view,
   * on the assumption that it was measured correctly at some point.
   */
  @UnsupportedAppUsage
  private void assumeLayout() {
    int width = mRight - mLeft - getCompoundPaddingLeft() - getCompoundPaddingRight();

    if (width < 1) {
      width = 0;
    }

    int physicalWidth = width;

    if (mHorizontallyScrolling) {
      width = VERY_WIDE;
    }

    makeNewLayout(width, physicalWidth, UNKNOWN_BORING, UNKNOWN_BORING,
                  physicalWidth, false);
  }

  @UnsupportedAppUsage
  private Layout.Alignment getLayoutAlignment() {
    Layout.Alignment alignment;
    switch (getTextAlignment()) {
      case TEXT_ALIGNMENT_GRAVITY:
        switch (mGravity & Gravity.RELATIVE_HORIZONTAL_GRAVITY_MASK) {
          case Gravity.START:
            alignment = Layout.Alignment.ALIGN_NORMAL;
            break;
          case Gravity.END:
            alignment = Layout.Alignment.ALIGN_OPPOSITE;
            break;
          case Gravity.LEFT:
            alignment = Layout.Alignment.ALIGN_LEFT;
            break;
          case Gravity.RIGHT:
            alignment = Layout.Alignment.ALIGN_RIGHT;
            break;
          case Gravity.CENTER_HORIZONTAL:
            alignment = Layout.Alignment.ALIGN_CENTER;
            break;
          default:
            alignment = Layout.Alignment.ALIGN_NORMAL;
            break;
        }
        break;
      case TEXT_ALIGNMENT_TEXT_START:
        alignment = Layout.Alignment.ALIGN_NORMAL;
        break;
      case TEXT_ALIGNMENT_TEXT_END:
        alignment = Layout.Alignment.ALIGN_OPPOSITE;
        break;
      case TEXT_ALIGNMENT_CENTER:
        alignment = Layout.Alignment.ALIGN_CENTER;
        break;
      case TEXT_ALIGNMENT_VIEW_START:
        alignment = (getLayoutDirection() == LAYOUT_DIRECTION_RTL)
                    ? Layout.Alignment.ALIGN_RIGHT : Layout.Alignment.ALIGN_LEFT;
        break;
      case TEXT_ALIGNMENT_VIEW_END:
        alignment = (getLayoutDirection() == LAYOUT_DIRECTION_RTL)
                    ? Layout.Alignment.ALIGN_LEFT : Layout.Alignment.ALIGN_RIGHT;
        break;
      case TEXT_ALIGNMENT_INHERIT:
        // This should never happen as we have already resolved the text alignment
        // but better safe than sorry so we just fall through
      default:
        alignment = Layout.Alignment.ALIGN_NORMAL;
        break;
    }
    return alignment;
  }

  private Paint.FontMetrics getResolvedMinimumFontMetrics() {
    if (mMinimumFontMetrics != null) {
      return mMinimumFontMetrics;
    }
    if (!mUseLocalePreferredLineHeightForMinimum) {
      return null;
    }

    if (mLocalePreferredFontMetrics == null) {
      mLocalePreferredFontMetrics = new Paint.FontMetrics();
    }
    mTextPaint.getFontMetricsForLocale(mLocalePreferredFontMetrics);
    return mLocalePreferredFontMetrics;
  }

  /**
   * The width passed in is now the desired layout width,
   * not the full view width with padding.
   * {@hide}
   */
  @VisibleForTesting
  @UnsupportedAppUsage
  public void makeNewLayout(int wantWidth, int hintWidth,
                            BoringLayout.Metrics boring,
                            BoringLayout.Metrics hintBoring,
                            int ellipsisWidth, boolean bringIntoView) {
    stopMarquee();

    // Update "old" cached values
    mOldMaximum = mMaximum;
    mOldMaxMode = mMaxMode;

    mHighlightPathBogus = true;
    mHighlightPathsBogus = true;

    if (wantWidth < 0) {
      wantWidth = 0;
    }
    if (hintWidth < 0) {
      hintWidth = 0;
    }

    Layout.Alignment alignment = getLayoutAlignment();
    final boolean testDirChange = mSingleLine && mLayout != null
                                  && (alignment == Layout.Alignment.ALIGN_NORMAL
                                      || alignment == Layout.Alignment.ALIGN_OPPOSITE);
    int oldDir = 0;
    if (testDirChange) oldDir = mLayout.getParagraphDirection(0);
    boolean shouldEllipsize = mEllipsize != null && getKeyListener() == null;
    final boolean switchEllipsize = mEllipsize == TruncateAt.MARQUEE
                                    && mMarqueeFadeMode != MARQUEE_FADE_NORMAL;
    TruncateAt effectiveEllipsize = mEllipsize;
    if (mEllipsize == TruncateAt.MARQUEE
        && mMarqueeFadeMode == MARQUEE_FADE_SWITCH_SHOW_ELLIPSIS) {
      effectiveEllipsize = TruncateAt.END_SMALL;
    }

    if (mTextDir == null) {
      mTextDir = getTextDirectionHeuristic();
    }

    mLayout = makeSingleLayout(wantWidth, boring, ellipsisWidth, alignment, shouldEllipsize,
                               effectiveEllipsize, effectiveEllipsize == mEllipsize);
    if (switchEllipsize) {
      TruncateAt oppositeEllipsize = effectiveEllipsize == TruncateAt.MARQUEE
                                     ? TruncateAt.END : TruncateAt.MARQUEE;
      mSavedMarqueeModeLayout = makeSingleLayout(wantWidth, boring, ellipsisWidth, alignment,
                                                 shouldEllipsize, oppositeEllipsize, effectiveEllipsize != mEllipsize);
    }

    shouldEllipsize = mEllipsize != null;
    mHintLayout = null;

    if (mHint != null) {
      if (shouldEllipsize) hintWidth = wantWidth;

      if (hintBoring == UNKNOWN_BORING) {
        hintBoring = BoringLayout.isBoring(mHint, mTextPaint, mTextDir,
                                           isFallbackLineSpacingForBoringLayout(),
                                           getResolvedMinimumFontMetrics(), mHintBoring);

        if (hintBoring != null) {
          mHintBoring = hintBoring;
        }
      }

      if (hintBoring != null) {
        if (hintBoring.width <= hintWidth
            && (!shouldEllipsize || hintBoring.width <= ellipsisWidth)) {
          if (mSavedHintLayout != null) {
            mHintLayout = mSavedHintLayout.replaceOrMake(mHint, mTextPaint,
                                                         hintWidth, alignment, mSpacingMult, mSpacingAdd,
                                                         hintBoring, mIncludePad);
          } else {
            mHintLayout = BoringLayout.make(mHint, mTextPaint,
                                            hintWidth, alignment, mSpacingMult, mSpacingAdd,
                                            hintBoring, mIncludePad);
          }

          mSavedHintLayout = (BoringLayout) mHintLayout;
        } else if (shouldEllipsize && hintBoring.width <= hintWidth) {
          if (mSavedHintLayout != null) {
            mHintLayout = mSavedHintLayout.replaceOrMake(mHint, mTextPaint,
                                                         hintWidth, alignment, mSpacingMult, mSpacingAdd,
                                                         hintBoring, mIncludePad, mEllipsize,
                                                         ellipsisWidth);
          } else {
            mHintLayout = BoringLayout.make(mHint, mTextPaint,
                                            hintWidth, alignment, mSpacingMult, mSpacingAdd,
                                            hintBoring, mIncludePad, mEllipsize,
                                            ellipsisWidth);
          }
        }
      }
      // TODO: code duplication with makeSingleLayout()
      if (mHintLayout == null) {
        StaticLayout.Builder builder = StaticLayout.Builder.obtain(mHint, 0,
                                                                   mHint.length(), mTextPaint, hintWidth)
          .setAlignment(alignment)
          .setTextDirection(mTextDir)
          .setLineSpacing(mSpacingAdd, mSpacingMult)
          .setIncludePad(mIncludePad)
          .setUseLineSpacingFromFallbacks(isFallbackLineSpacingForStaticLayout())
          .setBreakStrategy(mBreakStrategy)
          .setHyphenationFrequency(mHyphenationFrequency)
          .setJustificationMode(mJustificationMode)
          .setMaxLines(mMaxMode == LINES ? mMaximum : Integer.MAX_VALUE)
          .setLineBreakConfig(LineBreakConfig.getLineBreakConfig(
            mLineBreakStyle, mLineBreakWordStyle))
          .setUseBoundsForWidth(mUseBoundsForWidth)
          .setMinimumFontMetrics(getResolvedMinimumFontMetrics());

        if (shouldEllipsize) {
          builder.setEllipsize(mEllipsize)
            .setEllipsizedWidth(ellipsisWidth);
        }
        mHintLayout = builder.build();
      }
    }

    if (bringIntoView || (testDirChange && oldDir != mLayout.getParagraphDirection(0))) {
      registerForPreDraw();
    }

    if (mEllipsize == TextUtils.TruncateAt.MARQUEE) {
      if (!compressText(ellipsisWidth)) {
        final int height = mLayoutParams.height;
        // If the size of the view does not depend on the size of the text, try to
        // start the marquee immediately
        if (height != LayoutParams.WRAP_CONTENT && height != LayoutParams.MATCH_PARENT) {
          startMarquee();
        } else {
          // Defer the start of the marquee until we know our width (see setFrame())
          mRestartMarquee = true;
        }
      }
    }

    // CursorControllers need a non-null mLayout
    if (mEditor != null) mEditor.prepareCursorControllers();
  }

  /**
   * Returns true if DynamicLayout is required
   *
   * @hide
   */
  @VisibleForTesting
  public boolean useDynamicLayout() {
    return isTextSelectable() || (mSpannable != null && mPrecomputed == null);
  }

  /**
   * @hide
   */
  protected Layout makeSingleLayout(int wantWidth, BoringLayout.Metrics boring, int ellipsisWidth,
                                    Layout.Alignment alignment, boolean shouldEllipsize, TruncateAt effectiveEllipsize,
                                    boolean useSaved) {
    Layout result = null;
    if (useDynamicLayout()) {
      final DynamicLayout.Builder builder = DynamicLayout.Builder.obtain(mText, mTextPaint,
                                                                         wantWidth)
        .setDisplayText(mTransformed)
        .setAlignment(alignment)
        .setTextDirection(mTextDir)
        .setLineSpacing(mSpacingAdd, mSpacingMult)
        .setIncludePad(mIncludePad)
        .setUseLineSpacingFromFallbacks(isFallbackLineSpacingForStaticLayout())
        .setBreakStrategy(mBreakStrategy)
        .setHyphenationFrequency(mHyphenationFrequency)
        .setJustificationMode(mJustificationMode)
        .setLineBreakConfig(LineBreakConfig.getLineBreakConfig(
          mLineBreakStyle, mLineBreakWordStyle))
        .setUseBoundsForWidth(mUseBoundsForWidth)
        .setEllipsize(getKeyListener() == null ? effectiveEllipsize : null)
        .setEllipsizedWidth(ellipsisWidth)
        .setMinimumFontMetrics(getResolvedMinimumFontMetrics());
      result = builder.build();
    } else {
      if (boring == UNKNOWN_BORING) {
        boring = BoringLayout.isBoring(mTransformed, mTextPaint, mTextDir,
                                       isFallbackLineSpacingForBoringLayout(), getResolvedMinimumFontMetrics(),
                                       mBoring);
        if (boring != null) {
          mBoring = boring;
        }
      }

      if (boring != null) {
        if (boring.width <= wantWidth
            && (effectiveEllipsize == null || boring.width <= ellipsisWidth)) {
          if (useSaved && mSavedLayout != null) {
            result = mSavedLayout.replaceOrMake(mTransformed, mTextPaint,
                                                wantWidth, alignment, mSpacingMult, mSpacingAdd,
                                                boring, mIncludePad, null, wantWidth,
                                                isFallbackLineSpacingForBoringLayout(),
                                                mUseBoundsForWidth, getResolvedMinimumFontMetrics());
          } else {
            result = new BoringLayout(
              mTransformed,
              mTextPaint,
              wantWidth,
              alignment,
              mSpacingMult,
              mSpacingAdd,
              mIncludePad,
              isFallbackLineSpacingForBoringLayout(),
              wantWidth,
              null,
              boring,
              mUseBoundsForWidth,
              mShiftDrawingOffsetForStartOverhang,
              getResolvedMinimumFontMetrics());
          }

          if (useSaved) {
            mSavedLayout = (BoringLayout) result;
          }
        } else if (shouldEllipsize && boring.width <= wantWidth) {
          if (useSaved && mSavedLayout != null) {
            result = mSavedLayout.replaceOrMake(mTransformed, mTextPaint,
                                                wantWidth, alignment, mSpacingMult, mSpacingAdd,
                                                boring, mIncludePad, effectiveEllipsize,
                                                ellipsisWidth, isFallbackLineSpacingForBoringLayout(),
                                                mUseBoundsForWidth, getResolvedMinimumFontMetrics());
          } else {
            result = new BoringLayout(
              mTransformed,
              mTextPaint,
              wantWidth,
              alignment,
              mSpacingMult,
              mSpacingAdd,
              mIncludePad,
              isFallbackLineSpacingForBoringLayout(),
              ellipsisWidth,
              effectiveEllipsize,
              boring,
              mUseBoundsForWidth,
              mShiftDrawingOffsetForStartOverhang,
              getResolvedMinimumFontMetrics());
          }
        }
      }
    }
    if (result == null) {
      StaticLayout.Builder builder = StaticLayout.Builder.obtain(mTransformed,
                                                                 0, mTransformed.length(), mTextPaint, wantWidth)
        .setAlignment(alignment)
        .setTextDirection(mTextDir)
        .setLineSpacing(mSpacingAdd, mSpacingMult)
        .setIncludePad(mIncludePad)
        .setUseLineSpacingFromFallbacks(isFallbackLineSpacingForStaticLayout())
        .setBreakStrategy(mBreakStrategy)
        .setHyphenationFrequency(mHyphenationFrequency)
        .setJustificationMode(mJustificationMode)
        .setMaxLines(mMaxMode == LINES ? mMaximum : Integer.MAX_VALUE)
        .setLineBreakConfig(LineBreakConfig.getLineBreakConfig(
          mLineBreakStyle, mLineBreakWordStyle))
        .setUseBoundsForWidth(mUseBoundsForWidth)
        .setMinimumFontMetrics(getResolvedMinimumFontMetrics());
      if (shouldEllipsize) {
        builder.setEllipsize(effectiveEllipsize)
          .setEllipsizedWidth(ellipsisWidth);
      }
      result = builder.build();
    }
    return result;
  }

  @UnsupportedAppUsage
  private boolean compressText(float width) {
    if (isHardwareAccelerated()) return false;

    // Only compress the text if it hasn't been compressed by the previous pass
    if (width > 0.0f && mLayout != null && getLineCount() == 1 && !mUserSetTextScaleX
        && mTextPaint.getTextScaleX() == 1.0f) {
      final float textWidth = mLayout.getLineWidth(0);
      final float overflow = (textWidth + 1.0f - width) / width;
      if (overflow > 0.0f && overflow <= Marquee.MARQUEE_DELTA_MAX) {
        mTextPaint.setTextScaleX(1.0f - overflow - 0.005f);
        post(new Runnable() {
          public void run() {
            requestLayout();
          }
        });
        return true;
      }
    }

    return false;
  }

  private static int desired(Layout layout, boolean useBoundsForWidth) {
    int n = layout.getLineCount();
    CharSequence text = layout.getText();
    float max = 0;

    // if any line was wrapped, we can't use it.
    // but it's ok for the last line not to have a newline

    for (int i = 0; i < n - 1; i++) {
      if (text.charAt(layout.getLineEnd(i) - 1) != '\n') {
        return -1;
      }
    }

    for (int i = 0; i < n; i++) {
      max = Math.max(max, layout.getLineMax(i));
    }

    if (useBoundsForWidth) {
      max = Math.max(max, layout.computeDrawingBoundingBox().width());
    }

    return (int) Math.ceil(max);
  }

  /**
   * Set whether the TextView includes extra top and bottom padding to make
   * room for accents that go above the normal ascent and descent.
   * The default is true.
   *
   * @see #getIncludeFontPadding()
   *
   * @attr ref android.R.styleable#TextView_includeFontPadding
   */
  public void setIncludeFontPadding(boolean includepad) {
    if (mIncludePad != includepad) {
      mIncludePad = includepad;

      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Gets whether the TextView includes extra top and bottom padding to make
   * room for accents that go above the normal ascent and descent.
   *
   * @see #setIncludeFontPadding(boolean)
   *
   * @attr ref android.R.styleable#TextView_includeFontPadding
   */
  @InspectableProperty
  public boolean getIncludeFontPadding() {
    return mIncludePad;
  }

  /** @hide */
  @VisibleForTesting
  public static final BoringLayout.Metrics UNKNOWN_BORING = new BoringLayout.Metrics();

  @Override
  protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
    int widthMode = MeasureSpec.getMode(widthMeasureSpec);
    int heightMode = MeasureSpec.getMode(heightMeasureSpec);
    int widthSize = MeasureSpec.getSize(widthMeasureSpec);
    int heightSize = MeasureSpec.getSize(heightMeasureSpec);

    int width;
    int height;

    BoringLayout.Metrics boring = UNKNOWN_BORING;
    BoringLayout.Metrics hintBoring = UNKNOWN_BORING;

    if (mTextDir == null) {
      mTextDir = getTextDirectionHeuristic();
    }

    int des = -1;
    boolean fromexisting = false;
    final float widthLimit = (widthMode == MeasureSpec.AT_MOST)
                             ?  (float) widthSize : Float.MAX_VALUE;

    if (widthMode == MeasureSpec.EXACTLY) {
      // Parent has told us how big to be. So be it.
      width = widthSize;
    } else {
      if (mLayout != null && mEllipsize == null) {
        des = desired(mLayout, mUseBoundsForWidth);
      }

      if (des < 0) {
        boring = BoringLayout.isBoring(mTransformed, mTextPaint, mTextDir,
                                       isFallbackLineSpacingForBoringLayout(), getResolvedMinimumFontMetrics(),
                                       mBoring);
        if (boring != null) {
          mBoring = boring;
        }
      } else {
        fromexisting = true;
      }

      if (boring == null || boring == UNKNOWN_BORING) {
        if (des < 0) {
          des = (int) Math.ceil(Layout.getDesiredWidthWithLimit(mTransformed, 0,
                                                                mTransformed.length(), mTextPaint, mTextDir, widthLimit,
                                                                mUseBoundsForWidth));
        }
        width = des;
      } else {
        if (mUseBoundsForWidth) {
          width = Math.max(boring.width,
                           (int) Math.ceil(boring.getDrawingBoundingBox().width()));
        } else {
          width = boring.width;
        }
      }

      final Drawables dr = mDrawables;
      if (dr != null) {
        width = Math.max(width, dr.mDrawableWidthTop);
        width = Math.max(width, dr.mDrawableWidthBottom);
      }

      if (mHint != null) {
        int hintDes = -1;
        int hintWidth;

        if (mHintLayout != null && mEllipsize == null) {
          hintDes = desired(mHintLayout, mUseBoundsForWidth);
        }

        if (hintDes < 0) {
          hintBoring = BoringLayout.isBoring(mHint, mTextPaint, mTextDir,
                                             isFallbackLineSpacingForBoringLayout(), getResolvedMinimumFontMetrics(),
                                             mHintBoring);
          if (hintBoring != null) {
            mHintBoring = hintBoring;
          }
        }

        if (hintBoring == null || hintBoring == UNKNOWN_BORING) {
          if (hintDes < 0) {
            hintDes = (int) Math.ceil(Layout.getDesiredWidthWithLimit(mHint, 0,
                                                                      mHint.length(), mTextPaint, mTextDir, widthLimit,
                                                                      mUseBoundsForWidth));
          }
          hintWidth = hintDes;
        } else {
          hintWidth = hintBoring.width;
        }

        if (hintWidth > width) {
          width = hintWidth;
        }
      }

      width += getCompoundPaddingLeft() + getCompoundPaddingRight();

      if (mMaxWidthMode == EMS) {
        width = Math.min(width, mMaxWidth * getLineHeight());
      } else {
        width = Math.min(width, mMaxWidth);
      }

      if (mMinWidthMode == EMS) {
        width = Math.max(width, mMinWidth * getLineHeight());
      } else {
        width = Math.max(width, mMinWidth);
      }

      // Check against our minimum width
      width = Math.max(width, getSuggestedMinimumWidth());

      if (widthMode == MeasureSpec.AT_MOST) {
        width = Math.min(widthSize, width);
      }
    }

    int want = width - getCompoundPaddingLeft() - getCompoundPaddingRight();
    int unpaddedWidth = want;

    if (mHorizontallyScrolling) want = VERY_WIDE;

    int hintWant = want;
    int hintWidth = (mHintLayout == null) ? hintWant : mHintLayout.getWidth();

    if (mLayout == null) {
      makeNewLayout(want, hintWant, boring, hintBoring,
                    width - getCompoundPaddingLeft() - getCompoundPaddingRight(), false);
    } else {
      final boolean layoutChanged = (mLayout.getWidth() != want) || (hintWidth != hintWant)
                                    || (mLayout.getEllipsizedWidth()
                                        != width - getCompoundPaddingLeft() - getCompoundPaddingRight());

      final boolean widthChanged = (mHint == null) && (mEllipsize == null)
                                   && (want > mLayout.getWidth())
                                   && (mLayout instanceof BoringLayout
                                       || (fromexisting && des >= 0 && des <= want));

      final boolean maximumChanged = (mMaxMode != mOldMaxMode) || (mMaximum != mOldMaximum);

      if (layoutChanged || maximumChanged) {
        if (!maximumChanged && widthChanged) {
          mLayout.increaseWidthTo(want);
        } else {
          makeNewLayout(want, hintWant, boring, hintBoring,
                        width - getCompoundPaddingLeft() - getCompoundPaddingRight(), false);
        }
      } else {
        // Nothing has changed
      }
    }

    if (heightMode == MeasureSpec.EXACTLY) {
      // Parent has told us how big to be. So be it.
      height = heightSize;
      mDesiredHeightAtMeasure = -1;
    } else {
      int desired = getDesiredHeight();

      height = desired;
      mDesiredHeightAtMeasure = desired;

      if (heightMode == MeasureSpec.AT_MOST) {
        height = Math.min(desired, heightSize);
      }
    }

    int unpaddedHeight = height - getCompoundPaddingTop() - getCompoundPaddingBottom();
    if (mMaxMode == LINES && mLayout.getLineCount() > mMaximum) {
      unpaddedHeight = Math.min(unpaddedHeight, mLayout.getLineTop(mMaximum));
    }

    /*
     * We didn't let makeNewLayout() register to bring the cursor into view,
     * so do it here if there is any possibility that it is needed.
     */
    if (mMovement != null
        || mLayout.getWidth() > unpaddedWidth
        || mLayout.getHeight() > unpaddedHeight) {
      registerForPreDraw();
    } else {
      scrollTo(0, 0);
    }

    setMeasuredDimension(width, height);
  }

  /**
   * Automatically computes and sets the text size.
   */
  private void autoSizeText() {
    if (!isAutoSizeEnabled()) {
      return;
    }

    if (mNeedsAutoSizeText) {
      if (getMeasuredWidth() <= 0 || getMeasuredHeight() <= 0) {
        return;
      }

      final int availableWidth = mHorizontallyScrolling
                                 ? VERY_WIDE
                                 : getMeasuredWidth() - getTotalPaddingLeft() - getTotalPaddingRight();
      final int availableHeight = getMeasuredHeight() - getExtendedPaddingBottom()
                                  - getExtendedPaddingTop();

      if (availableWidth <= 0 || availableHeight <= 0) {
        return;
      }

      synchronized (TEMP_RECTF) {
        TEMP_RECTF.setEmpty();
        TEMP_RECTF.right = availableWidth;
        TEMP_RECTF.bottom = availableHeight;
        final float optimalTextSize = findLargestTextSizeWhichFits(TEMP_RECTF);

        if (optimalTextSize != getTextSize()) {
          setTextSizeInternal(TypedValue.COMPLEX_UNIT_PX, optimalTextSize,
                              false /* shouldRequestLayout */);

          makeNewLayout(availableWidth, 0 /* hintWidth */, UNKNOWN_BORING, UNKNOWN_BORING,
                        mRight - mLeft - getCompoundPaddingLeft() - getCompoundPaddingRight(),
                        false /* bringIntoView */);
        }
      }
    }
    // Always try to auto-size if enabled. Functions that do not want to trigger auto-sizing
    // after the next layout pass should set this to false.
    mNeedsAutoSizeText = true;
  }

  /**
   * Performs a binary search to find the largest text size that will still fit within the size
   * available to this view.
   */
  private int findLargestTextSizeWhichFits(RectF availableSpace) {
    final int sizesCount = mAutoSizeTextSizesInPx.length;
    if (sizesCount == 0) {
      throw new IllegalStateException("No available text sizes to choose from.");
    }

    int bestSizeIndex = 0;
    int lowIndex = bestSizeIndex + 1;
    int highIndex = sizesCount - 1;
    int sizeToTryIndex;
    while (lowIndex <= highIndex) {
      sizeToTryIndex = (lowIndex + highIndex) / 2;
      if (suggestedSizeFitsInSpace(mAutoSizeTextSizesInPx[sizeToTryIndex], availableSpace)) {
        bestSizeIndex = lowIndex;
        lowIndex = sizeToTryIndex + 1;
      } else {
        highIndex = sizeToTryIndex - 1;
        bestSizeIndex = highIndex;
      }
    }

    return mAutoSizeTextSizesInPx[bestSizeIndex];
  }

  private boolean suggestedSizeFitsInSpace(int suggestedSizeInPx, RectF availableSpace) {
    final CharSequence text = mTransformed != null
                              ? mTransformed
                              : getText();
    final int maxLines = getMaxLines();
    if (mTempTextPaint == null) {
      mTempTextPaint = new TextPaint();
    } else {
      mTempTextPaint.reset();
    }
    mTempTextPaint.set(getPaint());
    mTempTextPaint.setTextSize(suggestedSizeInPx);

    final StaticLayout.Builder layoutBuilder = StaticLayout.Builder.obtain(
      text, 0, text.length(),  mTempTextPaint, Math.round(availableSpace.right));
    layoutBuilder.setAlignment(getLayoutAlignment())
      .setLineSpacing(getLineSpacingExtra(), getLineSpacingMultiplier())
      .setIncludePad(getIncludeFontPadding())
      .setUseLineSpacingFromFallbacks(isFallbackLineSpacingForStaticLayout())
      .setBreakStrategy(getBreakStrategy())
      .setHyphenationFrequency(getHyphenationFrequency())
      .setJustificationMode(getJustificationMode())
      .setMaxLines(mMaxMode == LINES ? mMaximum : Integer.MAX_VALUE)
      .setTextDirection(getTextDirectionHeuristic())
      .setLineBreakConfig(LineBreakConfig.getLineBreakConfig(
        mLineBreakStyle, mLineBreakWordStyle))
      .setUseBoundsForWidth(mUseBoundsForWidth)
      .setMinimumFontMetrics(getResolvedMinimumFontMetrics());

    final StaticLayout layout = layoutBuilder.build();

    // Lines overflow.
    if (maxLines != -1 && layout.getLineCount() > maxLines) {
      return false;
    }

    // Height overflow.
    if (layout.getHeight() > availableSpace.bottom) {
      return false;
    }

    return true;
  }

  private int getDesiredHeight() {
    return Math.max(
      getDesiredHeight(mLayout, true),
      getDesiredHeight(mHintLayout, mEllipsize != null));
  }

  private int getDesiredHeight(Layout layout, boolean cap) {
    if (layout == null) {
      return 0;
    }

    /*
     * Don't cap the hint to a certain number of lines.
     * (Do cap it, though, if we have a maximum pixel height.)
     */
    int desired = layout.getHeight(cap);

    final Drawables dr = mDrawables;
    if (dr != null) {
      desired = Math.max(desired, dr.mDrawableHeightLeft);
      desired = Math.max(desired, dr.mDrawableHeightRight);
    }

    int linecount = layout.getLineCount();
    final int padding = getCompoundPaddingTop() + getCompoundPaddingBottom();
    desired += padding;

    if (mMaxMode != LINES) {
      desired = Math.min(desired, mMaximum);
    } else if (cap && linecount > mMaximum && (layout instanceof DynamicLayout
                                               || layout instanceof BoringLayout)) {
      desired = layout.getLineTop(mMaximum);

      if (dr != null) {
        desired = Math.max(desired, dr.mDrawableHeightLeft);
        desired = Math.max(desired, dr.mDrawableHeightRight);
      }

      desired += padding;
      linecount = mMaximum;
    }

    if (mMinMode == LINES) {
      if (linecount < mMinimum) {
        desired += getLineHeight() * (mMinimum - linecount);
      }
    } else {
      desired = Math.max(desired, mMinimum);
    }

    // Check against our minimum height
    desired = Math.max(desired, getSuggestedMinimumHeight());

    return desired;
  }

  /**
   * Check whether a change to the existing text layout requires a
   * new view layout.
   */
  private void checkForResize() {
    boolean sizeChanged = false;

    if (mLayout != null) {
      // Check if our width changed
      if (mLayoutParams.width == LayoutParams.WRAP_CONTENT) {
        sizeChanged = true;
        invalidate();
      }

      // Check if our height changed
      if (mLayoutParams.height == LayoutParams.WRAP_CONTENT) {
        int desiredHeight = getDesiredHeight();

        if (desiredHeight != this.getHeight()) {
          sizeChanged = true;
        }
      } else if (mLayoutParams.height == LayoutParams.MATCH_PARENT) {
        if (mDesiredHeightAtMeasure >= 0) {
          int desiredHeight = getDesiredHeight();

          if (desiredHeight != mDesiredHeightAtMeasure) {
            sizeChanged = true;
          }
        }
      }
    }

    if (sizeChanged) {
      requestLayout();
      // caller will have already invalidated
    }
  }

  /**
   * Check whether entirely new text requires a new view layout
   * or merely a new text layout.
   */
  @UnsupportedAppUsage
  private void checkForRelayout() {
    // If we have a fixed width, we can just swap in a new text layout
    // if the text height stays the same or if the view height is fixed.

    if ((mLayoutParams.width != LayoutParams.WRAP_CONTENT
         || (mMaxWidthMode == mMinWidthMode && mMaxWidth == mMinWidth))
        && (mHint == null || mHintLayout != null)
        && (mRight - mLeft - getCompoundPaddingLeft() - getCompoundPaddingRight() > 0)) {
      // Static width, so try making a new text layout.

      int oldht = mLayout.getHeight();
      int want = mLayout.getWidth();
      int hintWant = mHintLayout == null ? 0 : mHintLayout.getWidth();

      /*
       * No need to bring the text into view, since the size is not
       * changing (unless we do the requestLayout(), in which case it
       * will happen at measure).
       */
      makeNewLayout(want, hintWant, UNKNOWN_BORING, UNKNOWN_BORING,
                    mRight - mLeft - getCompoundPaddingLeft() - getCompoundPaddingRight(),
                    false);

      if (mEllipsize != TextUtils.TruncateAt.MARQUEE) {
        // In a fixed-height view, so use our new text layout.
        if (mLayoutParams.height != LayoutParams.WRAP_CONTENT
            && mLayoutParams.height != LayoutParams.MATCH_PARENT) {
          autoSizeText();
          invalidate();
          return;
        }

        // Dynamic height, but height has stayed the same,
        // so use our new text layout.
        if (mLayout.getHeight() == oldht
            && (mHintLayout == null || mHintLayout.getHeight() == oldht)) {
          autoSizeText();
          invalidate();
          return;
        }
      }

      // We lose: the height has changed and we have a dynamic height.
      // Request a new view layout using our new text layout.
      requestLayout();
      invalidate();
    } else {
      // Dynamic width, so we have no choice but to request a new
      // view layout with a new text layout.
      nullLayouts();
      requestLayout();
      invalidate();
    }
  }

  @Override
  protected void onLayout(boolean changed, int left, int top, int right, int bottom) {
    super.onLayout(changed, left, top, right, bottom);
    if (mDeferScroll >= 0) {
      int curs = mDeferScroll;
      mDeferScroll = -1;
      bringPointIntoView(Math.min(curs, mText.length()));
    }
    // Call auto-size after the width and height have been calculated.
    autoSizeText();
  }

  private boolean isShowingHint() {
    return TextUtils.isEmpty(mText) && !TextUtils.isEmpty(mHint) && !mHideHint;
  }

  /**
   * Returns true if anything changed.
   */
  @UnsupportedAppUsage
  private boolean bringTextIntoView() {
    Layout layout = isShowingHint() ? mHintLayout : mLayout;
    int line = 0;
    if ((mGravity & Gravity.VERTICAL_GRAVITY_MASK) == Gravity.BOTTOM) {
      line = layout.getLineCount() - 1;
    }

    Layout.Alignment a = layout.getParagraphAlignment(line);
    int dir = layout.getParagraphDirection(line);
    int hspace = mRight - mLeft - getCompoundPaddingLeft() - getCompoundPaddingRight();
    int vspace = mBottom - mTop - getExtendedPaddingTop() - getExtendedPaddingBottom();
    int ht = layout.getHeight();

    int scrollx, scrolly;

    // Convert to left, center, or right alignment.
    if (a == Layout.Alignment.ALIGN_NORMAL) {
      a = dir == Layout.DIR_LEFT_TO_RIGHT
          ? Layout.Alignment.ALIGN_LEFT : Layout.Alignment.ALIGN_RIGHT;
    } else if (a == Layout.Alignment.ALIGN_OPPOSITE) {
      a = dir == Layout.DIR_LEFT_TO_RIGHT
          ? Layout.Alignment.ALIGN_RIGHT : Layout.Alignment.ALIGN_LEFT;
    }

    if (a == Layout.Alignment.ALIGN_CENTER) {
      /*
       * Keep centered if possible, or, if it is too wide to fit,
       * keep leading edge in view.
       */

      int left = (int) Math.floor(layout.getLineLeft(line));
      int right = (int) Math.ceil(layout.getLineRight(line));

      if (right - left < hspace) {
        scrollx = (right + left) / 2 - hspace / 2;
      } else {
        if (dir < 0) {
          scrollx = right - hspace;
        } else {
          scrollx = left;
        }
      }
    } else if (a == Layout.Alignment.ALIGN_RIGHT) {
      int right = (int) Math.ceil(layout.getLineRight(line));
      scrollx = right - hspace;
    } else { // a == Layout.Alignment.ALIGN_LEFT (will also be the default)
      scrollx = (int) Math.floor(layout.getLineLeft(line));
    }

    if (ht < vspace) {
      scrolly = 0;
    } else {
      if ((mGravity & Gravity.VERTICAL_GRAVITY_MASK) == Gravity.BOTTOM) {
        scrolly = ht - vspace;
      } else {
        scrolly = 0;
      }
    }

    if (scrollx != mScrollX || scrolly != mScrollY) {
      scrollTo(scrollx, scrolly);
      return true;
    } else {
      return false;
    }
  }

  /**
   * Move the point, specified by the offset, into the view if it is needed.
   * This has to be called after layout. Returns true if anything changed.
   */
  public boolean bringPointIntoView(int offset) {
    return bringPointIntoView(offset, false);
  }

  /**
   * Move the insertion position of the given offset into visible area of the View.
   *
   * If the View is focused or {@code requestRectWithoutFocus} is set to true, this API may call
   * {@link View#requestRectangleOnScreen(Rect)} to bring the point to the visible area if
   * necessary.
   *
   * @param offset an offset of the character.
   * @param requestRectWithoutFocus True for calling {@link View#requestRectangleOnScreen(Rect)}
   *                                in the unfocused state. False for calling it only the View has
   *                                the focus.
   * @return true if anything changed, otherwise false.
   *
   * @see #bringPointIntoView(int)
   */
  public boolean bringPointIntoView(@IntRange(from = 0) int offset,
                                    boolean requestRectWithoutFocus) {
    if (isLayoutRequested()) {
      mDeferScroll = offset;
      return false;
    }
    final int offsetTransformed =
      originalToTransformed(offset, OffsetMapping.MAP_STRATEGY_CURSOR);
    boolean changed = false;

    Layout layout = isShowingHint() ? mHintLayout : mLayout;

    if (layout == null) return changed;

    int line = layout.getLineForOffset(offsetTransformed);

    int grav;

    switch (layout.getParagraphAlignment(line)) {
      case ALIGN_LEFT:
        grav = 1;
        break;
      case ALIGN_RIGHT:
        grav = -1;
        break;
      case ALIGN_NORMAL:
        grav = layout.getParagraphDirection(line);
        break;
      case ALIGN_OPPOSITE:
        grav = -layout.getParagraphDirection(line);
        break;
      case ALIGN_CENTER:
      default:
        grav = 0;
        break;
    }

    // We only want to clamp the cursor to fit within the layout width
    // in left-to-right modes, because in a right to left alignment,
    // we want to scroll to keep the line-right on the screen, as other
    // lines are likely to have text flush with the right margin, which
    // we want to keep visible.
    // A better long-term solution would probably be to measure both
    // the full line and a blank-trimmed version, and, for example, use
    // the latter measurement for centering and right alignment, but for
    // the time being we only implement the cursor clamping in left to
    // right where it is most likely to be annoying.
    final boolean clamped = grav > 0;
    // FIXME: Is it okay to truncate this, or should we round?
    final int x = (int) layout.getPrimaryHorizontal(offsetTransformed, clamped);
    final int top = layout.getLineTop(line);
    final int bottom = layout.getLineTop(line + 1);

    int left = (int) Math.floor(layout.getLineLeft(line));
    int right = (int) Math.ceil(layout.getLineRight(line));
    int ht = layout.getHeight();

    int hspace = mRight - mLeft - getCompoundPaddingLeft() - getCompoundPaddingRight();
    int vspace = mBottom - mTop - getExtendedPaddingTop() - getExtendedPaddingBottom();
    if (!mHorizontallyScrolling && right - left > hspace && right > x) {
      // If cursor has been clamped, make sure we don't scroll.
      right = Math.max(x, left + hspace);
    }

    int hslack = (bottom - top) / 2;
    int vslack = hslack;

    if (vslack > vspace / 4) {
      vslack = vspace / 4;
    }
    if (hslack > hspace / 4) {
      hslack = hspace / 4;
    }

    int hs = mScrollX;
    int vs = mScrollY;

    if (top - vs < vslack) {
      vs = top - vslack;
    }
    if (bottom - vs > vspace - vslack) {
      vs = bottom - (vspace - vslack);
    }
    if (ht - vs < vspace) {
      vs = ht - vspace;
    }
    if (0 - vs > 0) {
      vs = 0;
    }

    if (grav != 0) {
      if (x - hs < hslack) {
        hs = x - hslack;
      }
      if (x - hs > hspace - hslack) {
        hs = x - (hspace - hslack);
      }
    }

    if (grav < 0) {
      if (left - hs > 0) {
        hs = left;
      }
      if (right - hs < hspace) {
        hs = right - hspace;
      }
    } else if (grav > 0) {
      if (right - hs < hspace) {
        hs = right - hspace;
      }
      if (left - hs > 0) {
        hs = left;
      }
    } else /* grav == 0 */ {
      if (right - left <= hspace) {
        /*
         * If the entire text fits, center it exactly.
         */
        hs = left - (hspace - (right - left)) / 2;
      } else if (x > right - hslack) {
        /*
         * If we are near the right edge, keep the right edge
         * at the edge of the view.
         */
        hs = right - hspace;
      } else if (x < left + hslack) {
        /*
         * If we are near the left edge, keep the left edge
         * at the edge of the view.
         */
        hs = left;
      } else if (left > hs) {
        /*
         * Is there whitespace visible at the left?  Fix it if so.
         */
        hs = left;
      } else if (right < hs + hspace) {
        /*
         * Is there whitespace visible at the right?  Fix it if so.
         */
        hs = right - hspace;
      } else {
        /*
         * Otherwise, float as needed.
         */
        if (x - hs < hslack) {
          hs = x - hslack;
        }
        if (x - hs > hspace - hslack) {
          hs = x - (hspace - hslack);
        }
      }
    }

    if (hs != mScrollX || vs != mScrollY) {
      if (mScroller == null) {
        scrollTo(hs, vs);
      } else {
        long duration = AnimationUtils.currentAnimationTimeMillis() - mLastScroll;
        int dx = hs - mScrollX;
        int dy = vs - mScrollY;

        if (duration > ANIMATED_SCROLL_GAP) {
          mScroller.startScroll(mScrollX, mScrollY, dx, dy);
          awakenScrollBars(mScroller.getDuration());
          invalidate();
        } else {
          if (!mScroller.isFinished()) {
            mScroller.abortAnimation();
          }

          scrollBy(dx, dy);
        }

        mLastScroll = AnimationUtils.currentAnimationTimeMillis();
      }

      changed = true;
    }

    if (requestRectWithoutFocus || isFocused()) {
      // This offsets because getInterestingRect() is in terms of viewport coordinates, but
      // requestRectangleOnScreen() is in terms of content coordinates.

      // The offsets here are to ensure the rectangle we are using is
      // within our view bounds, in case the cursor is on the far left
      // or right.  If it isn't withing the bounds, then this request
      // will be ignored.
      if (mTempRect == null) mTempRect = new Rect();
      mTempRect.set(x - 2, top, x + 2, bottom);
      getInterestingRect(mTempRect, line);
      mTempRect.offset(mScrollX, mScrollY);

      if (requestRectangleOnScreen(mTempRect)) {
        changed = true;
      }
    }

    return changed;
  }

  /**
   * Move the cursor, if needed, so that it is at an offset that is visible
   * to the user.  This will not move the cursor if it represents more than
   * one character (a selection range).  This will only work if the
   * TextView contains spannable text; otherwise it will do nothing.
   *
   * @return True if the cursor was actually moved, false otherwise.
   */
  public boolean moveCursorToVisibleOffset() {
    if (!(mText instanceof Spannable)) {
      return false;
    }
    int start = getSelectionStartTransformed();
    int end = getSelectionEndTransformed();
    if (start != end) {
      return false;
    }

    // First: make sure the line is visible on screen:

    int line = mLayout.getLineForOffset(start);

    final int top = mLayout.getLineTop(line);
    final int bottom = mLayout.getLineTop(line + 1);
    final int vspace = mBottom - mTop - getExtendedPaddingTop() - getExtendedPaddingBottom();
    int vslack = (bottom - top) / 2;
    if (vslack > vspace / 4) {
      vslack = vspace / 4;
    }
    final int vs = mScrollY;

    if (top < (vs + vslack)) {
      line = mLayout.getLineForVertical(vs + vslack + (bottom - top));
    } else if (bottom > (vspace + vs - vslack)) {
      line = mLayout.getLineForVertical(vspace + vs - vslack - (bottom - top));
    }

    // Next: make sure the character is visible on screen:

    final int hspace = mRight - mLeft - getCompoundPaddingLeft() - getCompoundPaddingRight();
    final int hs = mScrollX;
    final int leftChar = mLayout.getOffsetForHorizontal(line, hs);
    final int rightChar = mLayout.getOffsetForHorizontal(line, hspace + hs);

    // line might contain bidirectional text
    final int lowChar = leftChar < rightChar ? leftChar : rightChar;
    final int highChar = leftChar > rightChar ? leftChar : rightChar;

    int newStart = start;
    if (newStart < lowChar) {
      newStart = lowChar;
    } else if (newStart > highChar) {
      newStart = highChar;
    }

    if (newStart != start) {
      Selection.setSelection(mSpannable,
                             transformedToOriginal(newStart, OffsetMapping.MAP_STRATEGY_CURSOR));
      return true;
    }

    return false;
  }

  @Override
  public void computeScroll() {
    if (mScroller != null) {
      if (mScroller.computeScrollOffset()) {
        mScrollX = mScroller.getCurrX();
        mScrollY = mScroller.getCurrY();
        invalidateParentCaches();
        postInvalidate();  // So we draw again
      }
    }
  }

  private void getInterestingRect(Rect r, int line) {
    convertFromViewportToContentCoordinates(r);

    // Rectangle can can be expanded on first and last line to take
    // padding into account.
    // TODO Take left/right padding into account too?
    if (line == 0) r.top -= getExtendedPaddingTop();
    if (line == mLayout.getLineCount() - 1) r.bottom += getExtendedPaddingBottom();
  }

  private void convertFromViewportToContentCoordinates(Rect r) {
    final int horizontalOffset = viewportToContentHorizontalOffset();
    r.left += horizontalOffset;
    r.right += horizontalOffset;

    final int verticalOffset = viewportToContentVerticalOffset();
    r.top += verticalOffset;
    r.bottom += verticalOffset;
  }

  private PointF convertFromScreenToContentCoordinates(PointF point) {
    int[] screenToViewport = getLocationOnScreen();
    PointF copy = new PointF(point);
    copy.offset(
      -(screenToViewport[0] + viewportToContentHorizontalOffset()),
      -(screenToViewport[1] + viewportToContentVerticalOffset()));
    return copy;
  }

  private RectF convertFromScreenToContentCoordinates(RectF rect) {
    int[] screenToViewport = getLocationOnScreen();
    RectF copy = new RectF(rect);
    copy.offset(
      -(screenToViewport[0] + viewportToContentHorizontalOffset()),
      -(screenToViewport[1] + viewportToContentVerticalOffset()));
    return copy;
  }

  int viewportToContentHorizontalOffset() {
    return getCompoundPaddingLeft() - mScrollX;
  }

  @UnsupportedAppUsage
  int viewportToContentVerticalOffset() {
    int offset = getExtendedPaddingTop() - mScrollY;
    if ((mGravity & Gravity.VERTICAL_GRAVITY_MASK) != Gravity.TOP) {
      offset += getVerticalOffset(false);
    }
    return offset;
  }

  @Override
  public void debug(int depth) {
    super.debug(depth);

    String output = debugIndent(depth);
    output += "frame={" + mLeft + ", " + mTop + ", " + mRight
              + ", " + mBottom + "} scroll={" + mScrollX + ", " + mScrollY
              + "} ";

    if (mText != null) {

      output += "mText=\"" + mText + "\" ";
      if (mLayout != null) {
        output += "mLayout width=" + mLayout.getWidth()
                  + " height=" + mLayout.getHeight();
      }
    } else {
      output += "mText=NULL";
    }
    Log.d(VIEW_LOG_TAG, output);
  }

  /**
   * Convenience for {@link Selection#getSelectionStart}.
   */
  @ViewDebug.ExportedProperty(category = "text")
  public int getSelectionStart() {
    return Selection.getSelectionStart(getText());
  }

  /**
   * Convenience for {@link Selection#getSelectionEnd}.
   */
  @ViewDebug.ExportedProperty(category = "text")
  public int getSelectionEnd() {
    return Selection.getSelectionEnd(getText());
  }

  /**
   * Calculates the rectangles which should be highlighted to indicate a selection between start
   * and end and feeds them into the given {@link Layout.SelectionRectangleConsumer}.
   *
   * @param start    the starting index of the selection
   * @param end      the ending index of the selection
   * @param consumer the {@link Layout.SelectionRectangleConsumer} which will receive the
   *                 generated rectangles. It will be called every time a rectangle is generated.
   * @hide
   */
  public void getSelection(int start, int end, final Layout.SelectionRectangleConsumer consumer) {
    final int transformedStart =
      originalToTransformed(start, OffsetMapping.MAP_STRATEGY_CURSOR);
    final int transformedEnd = originalToTransformed(end, OffsetMapping.MAP_STRATEGY_CURSOR);
    mLayout.getSelection(transformedStart, transformedEnd, consumer);
  }

  int getSelectionStartTransformed() {
    final int start = getSelectionStart();
    if (start < 0) return start;
    return originalToTransformed(start, OffsetMapping.MAP_STRATEGY_CURSOR);
  }

  int getSelectionEndTransformed() {
    final int end = getSelectionEnd();
    if (end < 0) return end;
    return originalToTransformed(end, OffsetMapping.MAP_STRATEGY_CURSOR);
  }

  /**
   * Return true iff there is a selection of nonzero length inside this text view.
   */
  public boolean hasSelection() {
    final int selectionStart = getSelectionStart();
    final int selectionEnd = getSelectionEnd();
    final int selectionMin;
    final int selectionMax;
    if (selectionStart < selectionEnd) {
      selectionMin = selectionStart;
      selectionMax = selectionEnd;
    } else {
      selectionMin = selectionEnd;
      selectionMax = selectionStart;
    }

    return selectionMin >= 0 && selectionMax > 0 && selectionMin != selectionMax;
  }

  String getSelectedText() {
    if (!hasSelection()) {
      return null;
    }

    final int start = getSelectionStart();
    final int end = getSelectionEnd();
    return String.valueOf(
      start > end ? mText.subSequence(end, start) : mText.subSequence(start, end));
  }

  /**
   * Sets the properties of this field (lines, horizontally scrolling,
   * transformation method) to be for a single-line input.
   *
   * @attr ref android.R.styleable#TextView_singleLine
   */
  public void setSingleLine() {
    setSingleLine(true);
  }

  /**
   * Sets the properties of this field to transform input to ALL CAPS
   * display. This may use a "small caps" formatting if available.
   * This setting will be ignored if this field is editable or selectable.
   *
   * This call replaces the current transformation method. Disabling this
   * will not necessarily restore the previous behavior from before this
   * was enabled.
   *
   * @see #setTransformationMethod(TransformationMethod)
   * @attr ref android.R.styleable#TextView_textAllCaps
   */
  @android.view.RemotableViewMethod
  public void setAllCaps(boolean allCaps) {
    if (allCaps) {
      setTransformationMethod(new AllCapsTransformationMethod(getContext()));
    } else {
      setTransformationMethod(null);
    }
  }

  /**
   *
   * Checks whether the transformation method applied to this TextView is set to ALL CAPS.
   * @return Whether the current transformation method is for ALL CAPS.
   *
   * @see #setAllCaps(boolean)
   * @see #setTransformationMethod(TransformationMethod)
   */
  @InspectableProperty(name = "textAllCaps")
  public boolean isAllCaps() {
    final TransformationMethod method = getTransformationMethod();
    return method != null && method instanceof AllCapsTransformationMethod;
  }

  /**
   * If true, sets the properties of this field (number of lines, horizontally scrolling,
   * transformation method) to be for a single-line input; if false, restores these to the default
   * conditions.
   *
   * Note that the default conditions are not necessarily those that were in effect prior this
   * method, and you may want to reset these properties to your custom values.
   *
   * Note that due to performance reasons, by setting single line for the EditText, the maximum
   * text length is set to 5000 if no other character limitation are applied.
   *
   * @attr ref android.R.styleable#TextView_singleLine
   */
  @android.view.RemotableViewMethod
  public void setSingleLine(boolean singleLine) {
    // Could be used, but may break backward compatibility.
    // if (mSingleLine == singleLine) return;
    setInputTypeSingleLine(singleLine);
    applySingleLine(singleLine, true, true, true);
  }

  /**
   * Adds or remove the EditorInfo.TYPE_TEXT_FLAG_MULTI_LINE on the mInputType.
   * @param singleLine
   */
  private void setInputTypeSingleLine(boolean singleLine) {
    if (mEditor != null
        && (mEditor.mInputType & EditorInfo.TYPE_MASK_CLASS)
           == EditorInfo.TYPE_CLASS_TEXT) {
      if (singleLine) {
        mEditor.mInputType &= ~EditorInfo.TYPE_TEXT_FLAG_MULTI_LINE;
      } else {
        mEditor.mInputType |= EditorInfo.TYPE_TEXT_FLAG_MULTI_LINE;
      }
    }
  }

  private void applySingleLine(boolean singleLine, boolean applyTransformation,
                               boolean changeMaxLines, boolean changeMaxLength) {
    mSingleLine = singleLine;

    if (singleLine) {
      setLines(1);
      setHorizontallyScrolling(true);
      if (applyTransformation) {
        setTransformationMethod(SingleLineTransformationMethod.getInstance());
      }

      if (!changeMaxLength) return;

      // Single line length filter is only applicable editable text.
      if (mBufferType != BufferType.EDITABLE) return;

      final InputFilter[] prevFilters = getFilters();
      for (InputFilter filter: getFilters()) {
        // We don't add LengthFilter if already there.
        if (filter instanceof InputFilter.LengthFilter) return;
      }

      if (mSingleLineLengthFilter == null) {
        mSingleLineLengthFilter = new InputFilter.LengthFilter(
          MAX_LENGTH_FOR_SINGLE_LINE_EDIT_TEXT);
      }

      final InputFilter[] newFilters = new InputFilter[prevFilters.length + 1];
      System.arraycopy(prevFilters, 0, newFilters, 0, prevFilters.length);
      newFilters[prevFilters.length] = mSingleLineLengthFilter;

      setFilters(newFilters);

      // Since filter doesn't apply to existing text, trigger filter by setting text.
      setText(getText());
    } else {
      if (changeMaxLines) {
        setMaxLines(Integer.MAX_VALUE);
      }
      setHorizontallyScrolling(false);
      if (applyTransformation) {
        setTransformationMethod(null);
      }

      if (!changeMaxLength) return;

      // Single line length filter is only applicable editable text.
      if (mBufferType != BufferType.EDITABLE) return;

      final InputFilter[] prevFilters = getFilters();
      if (prevFilters.length == 0) return;

      // Short Circuit: if mSingleLineLengthFilter is not allocated, nobody sets automated
      // single line char limit filter.
      if (mSingleLineLengthFilter == null) return;

      // If we need to remove mSingleLineLengthFilter, we need to allocate another array.
      // Since filter list is expected to be small and want to avoid unnecessary array
      // allocation, check if there is mSingleLengthFilter first.
      int targetIndex = -1;
      for (int i = 0; i < prevFilters.length; ++i) {
        if (prevFilters[i] == mSingleLineLengthFilter) {
          targetIndex = i;
          break;
        }
      }
      if (targetIndex == -1) return;  // not found. Do nothing.

      if (prevFilters.length == 1) {
        setFilters(NO_FILTERS);
        return;
      }

      // Create new array which doesn't include mSingleLengthFilter.
      final InputFilter[] newFilters = new InputFilter[prevFilters.length - 1];
      System.arraycopy(prevFilters, 0, newFilters, 0, targetIndex);
      System.arraycopy(
        prevFilters,
        targetIndex + 1,
        newFilters,
        targetIndex,
        prevFilters.length - targetIndex - 1);
      setFilters(newFilters);
      mSingleLineLengthFilter = null;
    }
  }

  /**
   * Causes words in the text that are longer than the view's width
   * to be ellipsized instead of broken in the middle.  You may also
   * want to {@link #setSingleLine} or {@link #setHorizontallyScrolling}
   * to constrain the text to a single line.  Use <code>null</code>
   * to turn off ellipsizing.
   *
   * If {@link #setMaxLines} has been used to set two or more lines,
   * only {@link android.text.TextUtils.TruncateAt#END} and
   * {@link android.text.TextUtils.TruncateAt#MARQUEE} are supported
   * (other ellipsizing types will not do anything).
   *
   * @attr ref android.R.styleable#TextView_ellipsize
   */
  public void setEllipsize(TextUtils.TruncateAt where) {
    // TruncateAt is an enum. != comparison is ok between these singleton objects.
    if (mEllipsize != where) {
      mEllipsize = where;

      if (mLayout != null) {
        nullLayouts();
        requestLayout();
        invalidate();
      }
    }
  }

  /**
   * Sets how many times to repeat the marquee animation. Only applied if the
   * TextView has marquee enabled. Set to -1 to repeat indefinitely.
   *
   * @see #getMarqueeRepeatLimit()
   *
   * @attr ref android.R.styleable#TextView_marqueeRepeatLimit
   */
  public void setMarqueeRepeatLimit(int marqueeLimit) {
    mMarqueeRepeatLimit = marqueeLimit;
  }

  /**
   * Gets the number of times the marquee animation is repeated. Only meaningful if the
   * TextView has marquee enabled.
   *
   * @return the number of times the marquee animation is repeated. -1 if the animation
   * repeats indefinitely
   *
   * @see #setMarqueeRepeatLimit(int)
   *
   * @attr ref android.R.styleable#TextView_marqueeRepeatLimit
   */
  @InspectableProperty
  public int getMarqueeRepeatLimit() {
    return mMarqueeRepeatLimit;
  }

  /**
   * Returns where, if anywhere, words that are longer than the view
   * is wide should be ellipsized.
   */
  @InspectableProperty
  @ViewDebug.ExportedProperty
  public TextUtils.TruncateAt getEllipsize() {
    return mEllipsize;
  }

  /**
   * Set the TextView so that when it takes focus, all the text is
   * selected.
   *
   * @attr ref android.R.styleable#TextView_selectAllOnFocus
   */
  @android.view.RemotableViewMethod
  public void setSelectAllOnFocus(boolean selectAllOnFocus) {
    createEditorIfNeeded();
    mEditor.mSelectAllOnFocus = selectAllOnFocus;

    if (selectAllOnFocus && !(mText instanceof Spannable)) {
      setText(mText, BufferType.SPANNABLE);
    }
  }

  /**
   * Set whether the cursor is visible. The default is true. Note that this property only
   * makes sense for editable TextView. If IME is consuming the input, the cursor will always be
   * invisible, visibility will be updated as the last state when IME does not consume
   * the input anymore.
   *
   * @see #isCursorVisible()
   *
   * @attr ref android.R.styleable#TextView_cursorVisible
   */
  @android.view.RemotableViewMethod
  public void setCursorVisible(boolean visible) {
    mCursorVisibleFromAttr = visible;
    updateCursorVisibleInternal();
  }

  /**
   * Sets the IME is consuming the input and make the cursor invisible if {@code imeConsumesInput}
   * is {@code true}. Otherwise, make the cursor visible.
   *
   * @param imeConsumesInput {@code true} if IME is consuming the input
   *
   * @hide
   */
  public void setImeConsumesInput(boolean imeConsumesInput) {
    mImeIsConsumingInput = imeConsumesInput;
    updateCursorVisibleInternal();
  }

  private void updateCursorVisibleInternal()  {
    boolean visible = mCursorVisibleFromAttr && !mImeIsConsumingInput;
    if (visible && mEditor == null) return; // visible is the default value with no edit data
    createEditorIfNeeded();
    if (mEditor.mCursorVisible != visible) {
      mEditor.mCursorVisible = visible;
      invalidate();

      mEditor.makeBlink();

      // InsertionPointCursorController depends on mCursorVisible
      mEditor.prepareCursorControllers();
    }
  }

  /**
   * @return whether or not the cursor is visible (assuming this TextView is editable). This
   * method may return {@code false} when the IME is consuming the input even if the
   * {@code mEditor.mCursorVisible} attribute is {@code true} or {@code #setCursorVisible(true)}
   * is called.
   *
   * @see #setCursorVisible(boolean)
   *
   * @attr ref android.R.styleable#TextView_cursorVisible
   */
  @InspectableProperty
  public boolean isCursorVisible() {
    // true is the default value
    return mEditor == null ? true : mEditor.mCursorVisible;
  }

  /**
   * @return whether cursor is visible without regard to {@code mImeIsConsumingInput}.
   * {@code true} is the default value.
   *
   * @see #setCursorVisible(boolean)
   * @hide
   */
  public boolean isCursorVisibleFromAttr() {
    return mCursorVisibleFromAttr;
  }

  private boolean canMarquee() {
    int width = mRight - mLeft - getCompoundPaddingLeft() - getCompoundPaddingRight();
    return width > 0 && (mLayout.getLineWidth(0) > width
                         || (mMarqueeFadeMode != MARQUEE_FADE_NORMAL && mSavedMarqueeModeLayout != null
                             && mSavedMarqueeModeLayout.getLineWidth(0) > width));
  }

  /**
   * @hide
   */
  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023)
  protected void startMarquee() {
    // Do not ellipsize EditText
    if (getKeyListener() != null) return;

    if (compressText(getWidth() - getCompoundPaddingLeft() - getCompoundPaddingRight())) {
      return;
    }

    if ((mMarquee == null || mMarquee.isStopped()) && isAggregatedVisible()
        && (isFocused() || isSelected()) && getLineCount() == 1 && canMarquee()) {

      if (mMarqueeFadeMode == MARQUEE_FADE_SWITCH_SHOW_ELLIPSIS) {
        mMarqueeFadeMode = MARQUEE_FADE_SWITCH_SHOW_FADE;
        final Layout tmp = mLayout;
        mLayout = mSavedMarqueeModeLayout;
        mSavedMarqueeModeLayout = tmp;
        setHorizontalFadingEdgeEnabled(true);
        requestLayout();
        invalidate();
      }

      if (mMarquee == null) mMarquee = new Marquee(this);
      mMarquee.start(mMarqueeRepeatLimit);
    }
  }

  /**
   * @hide
   */
  protected void stopMarquee() {
    if (mMarquee != null && !mMarquee.isStopped()) {
      mMarquee.stop();
    }

    if (mMarqueeFadeMode == MARQUEE_FADE_SWITCH_SHOW_FADE) {
      mMarqueeFadeMode = MARQUEE_FADE_SWITCH_SHOW_ELLIPSIS;
      final Layout tmp = mSavedMarqueeModeLayout;
      mSavedMarqueeModeLayout = mLayout;
      mLayout = tmp;
      setHorizontalFadingEdgeEnabled(false);
      requestLayout();
      invalidate();
    }
  }

  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023)
  private void startStopMarquee(boolean start) {
    if (mEllipsize == TextUtils.TruncateAt.MARQUEE) {
      if (start) {
        startMarquee();
      } else {
        stopMarquee();
      }
    }
  }

  /**
   * This method is called when the text is changed, in case any subclasses
   * would like to know.
   *
   * Within <code>text</code>, the <code>lengthAfter</code> characters
   * beginning at <code>start</code> have just replaced old text that had
   * length <code>lengthBefore</code>. It is an error to attempt to make
   * changes to <code>text</code> from this callback.
   *
   * @param text The text the TextView is displaying
   * @param start The offset of the start of the range of the text that was
   * modified
   * @param lengthBefore The length of the former text that has been replaced
   * @param lengthAfter The length of the replacement modified text
   */
  protected void onTextChanged(CharSequence text, int start, int lengthBefore, int lengthAfter) {
    // intentionally empty, template pattern method can be overridden by subclasses
  }

  /**
   * This method is called when the selection has changed, in case any
   * subclasses would like to know.
   * </p>
   * <p class="note"><strong>Note:</strong> Always call the super implementation, which informs
   * the accessibility subsystem about the selection change.
   * </p>
   *
   * @param selStart The new selection start location.
   * @param selEnd The new selection end location.
   */
  @CallSuper
  protected void onSelectionChanged(int selStart, int selEnd) {
    sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_TEXT_SELECTION_CHANGED);
  }

  /**
   * Adds a TextWatcher to the list of those whose methods are called
   * whenever this TextView's text changes.
   * <p>
   * In 1.0, the {@link TextWatcher#afterTextChanged} method was erroneously
   * not called after {@link #setText} calls.  Now, doing {@link #setText}
   * if there are any text changed listeners forces the buffer type to
   * Editable if it would not otherwise be and does call this method.
   */
  public void addTextChangedListener(TextWatcher watcher) {
    if (mListeners == null) {
      mListeners = new ArrayList<TextWatcher>();
    }

    mListeners.add(watcher);
  }

  /**
   * Removes the specified TextWatcher from the list of those whose
   * methods are called
   * whenever this TextView's text changes.
   */
  public void removeTextChangedListener(TextWatcher watcher) {
    if (mListeners != null) {
      int i = mListeners.indexOf(watcher);

      if (i >= 0) {
        mListeners.remove(i);
      }
    }
  }

  private void sendBeforeTextChanged(CharSequence text, int start, int before, int after) {
    if (mListeners != null) {
      final ArrayList<TextWatcher> list = mListeners;
      final int count = list.size();
      for (int i = 0; i < count; i++) {
        list.get(i).beforeTextChanged(text, start, before, after);
      }
    }

    // The spans that are inside or intersect the modified region no longer make sense
    removeIntersectingNonAdjacentSpans(start, start + before, SpellCheckSpan.class);
    removeIntersectingNonAdjacentSpans(start, start + before, SuggestionSpan.class);
  }

  // Removes all spans that are inside or actually overlap the start..end range
  private <T> void removeIntersectingNonAdjacentSpans(int start, int end, Class<T> type) {
    if (!(mText instanceof Editable)) return;
    Editable text = (Editable) mText;

    T[] spans = text.getSpans(start, end, type);
    ArrayList<T> spansToRemove = new ArrayList<>();
    for (T span : spans) {
      final int spanStart = text.getSpanStart(span);
      final int spanEnd = text.getSpanEnd(span);
      if (spanEnd == start || spanStart == end) continue;
      spansToRemove.add(span);
    }
    for (T span : spansToRemove) {
      text.removeSpan(span);
    }
  }

  void removeAdjacentSuggestionSpans(final int pos) {
    if (!(mText instanceof Editable)) return;
    final Editable text = (Editable) mText;

    final SuggestionSpan[] spans = text.getSpans(pos, pos, SuggestionSpan.class);
    final int length = spans.length;
    for (int i = 0; i < length; i++) {
      final int spanStart = text.getSpanStart(spans[i]);
      final int spanEnd = text.getSpanEnd(spans[i]);
      if (spanEnd == pos || spanStart == pos) {
        if (SpellChecker.haveWordBoundariesChanged(text, pos, pos, spanStart, spanEnd)) {
          text.removeSpan(spans[i]);
        }
      }
    }
  }

  /**
   * Not private so it can be called from an inner class without going
   * through a thunk.
   */
  void sendOnTextChanged(CharSequence text, int start, int before, int after) {
    if (mListeners != null) {
      final ArrayList<TextWatcher> list = mListeners;
      final int count = list.size();
      for (int i = 0; i < count; i++) {
        list.get(i).onTextChanged(text, start, before, after);
      }
    }

    if (mEditor != null) mEditor.sendOnTextChanged(start, before, after);
  }

  /**
   * Not private so it can be called from an inner class without going
   * through a thunk.
   */
  void sendAfterTextChanged(Editable text) {
    if (mListeners != null) {
      final ArrayList<TextWatcher> list = mListeners;
      final int count = list.size();
      for (int i = 0; i < count; i++) {
        list.get(i).afterTextChanged(text);
      }
    }

    notifyListeningManagersAfterTextChanged();

    hideErrorIfUnchanged();
  }

  /**
   * Notify managers (such as {@link AutofillManager} and {@link ContentCaptureManager}) that are
   * interested on text changes.
   */
  private void notifyListeningManagersAfterTextChanged() {

    // Autofill
    if (isAutofillable()) {
      // It is important to not check whether the view is important for autofill
      // since the user can trigger autofill manually on not important views.
      final AutofillManager afm = mContext.getSystemService(AutofillManager.class);
      if (afm != null) {
        if (android.view.autofill.Helper.sVerbose) {
          Log.v(LOG_TAG, "notifyAutoFillManagerAfterTextChanged");
        }
        afm.notifyValueChanged(TextView.this);
      }
    }

    notifyContentCaptureTextChanged();
  }

  /**
   * Notifies the ContentCapture service that the text of the view has changed (only if
   * ContentCapture has been notified of this view's existence already).
   *
   * @hide
   */
  public void notifyContentCaptureTextChanged() {
    // TODO(b/121045053): should use a flag / boolean to keep status of SHOWN / HIDDEN instead
    // of using isLaidout(), so it's not called in cases where it's laid out but a
    // notifyAppeared was not sent.
    if (isLaidOut() && isImportantForContentCapture() && getNotifiedContentCaptureAppeared()) {
      final ContentCaptureManager cm = mContext.getSystemService(ContentCaptureManager.class);
      if (cm != null && cm.isContentCaptureEnabled()) {
        final ContentCaptureSession session = getContentCaptureSession();
        if (session != null) {
          // TODO(b/111276913): pass flags when edited by user / add CTS test
          session.notifyViewTextChanged(getAutofillId(), getText());
        }
      }
    }
  }

  private boolean isAutofillable() {
    // It is important to not check whether the view is important for autofill
    // since the user can trigger autofill manually on not important views.
    return getAutofillType() != AUTOFILL_TYPE_NONE;
  }

  void updateAfterEdit() {
    invalidate();
    int curs = getSelectionStart();

    if (curs >= 0 || (mGravity & Gravity.VERTICAL_GRAVITY_MASK) == Gravity.BOTTOM) {
      registerForPreDraw();
    }

    checkForResize();

    if (curs >= 0) {
      mHighlightPathBogus = true;
      if (mEditor != null) mEditor.makeBlink();
      bringPointIntoView(curs);
    }
  }

  /**
   * Not private so it can be called from an inner class without going
   * through a thunk.
   */
  void handleTextChanged(CharSequence buffer, int start, int before, int after) {
    sLastCutCopyOrTextChangedTime = 0;

    final Editor.InputMethodState ims = mEditor == null ? null : mEditor.mInputMethodState;
    if (ims == null || ims.mBatchEditNesting == 0) {
      updateAfterEdit();
    }
    if (ims != null) {
      ims.mContentChanged = true;
      if (ims.mChangedStart < 0) {
        ims.mChangedStart = start;
        ims.mChangedEnd = start + before;
      } else {
        ims.mChangedStart = Math.min(ims.mChangedStart, start);
        ims.mChangedEnd = Math.max(ims.mChangedEnd, start + before - ims.mChangedDelta);
      }
      ims.mChangedDelta += after - before;
    }
    resetErrorChangedFlag();
    sendOnTextChanged(buffer, start, before, after);
    onTextChanged(buffer, start, before, after);

    mHideHint = false;
    clearGesturePreviewHighlight();
  }

  /**
   * Not private so it can be called from an inner class without going
   * through a thunk.
   */
  void spanChange(Spanned buf, Object what, int oldStart, int newStart, int oldEnd, int newEnd) {
    // XXX Make the start and end move together if this ends up
    // spending too much time invalidating.

    boolean selChanged = false;
    int newSelStart = -1, newSelEnd = -1;

    final Editor.InputMethodState ims = mEditor == null ? null : mEditor.mInputMethodState;

    if (what == Selection.SELECTION_END) {
      selChanged = true;
      newSelEnd = newStart;

      if (oldStart >= 0 || newStart >= 0) {
        invalidateCursor(Selection.getSelectionStart(buf), oldStart, newStart);
        checkForResize();
        registerForPreDraw();
        if (mEditor != null) mEditor.makeBlink();
      }
    }

    if (what == Selection.SELECTION_START) {
      selChanged = true;
      newSelStart = newStart;

      if (oldStart >= 0 || newStart >= 0) {
        int end = Selection.getSelectionEnd(buf);
        invalidateCursor(end, oldStart, newStart);
      }
    }

    if (selChanged) {
      clearGesturePreviewHighlight();
      mHighlightPathBogus = true;
      if (mEditor != null && !isFocused()) mEditor.mSelectionMoved = true;

      if ((buf.getSpanFlags(what) & Spanned.SPAN_INTERMEDIATE) == 0) {
        if (newSelStart < 0) {
          newSelStart = Selection.getSelectionStart(buf);
        }
        if (newSelEnd < 0) {
          newSelEnd = Selection.getSelectionEnd(buf);
        }

        if (mEditor != null) {
          mEditor.refreshTextActionMode();
          if (!hasSelection()
              && mEditor.getTextActionMode() == null && hasTransientState()) {
            // User generated selection has been removed.
            setHasTransientState(false);
          }
        }
        onSelectionChanged(newSelStart, newSelEnd);
      }
    }

    if (what instanceof UpdateAppearance || what instanceof ParagraphStyle
        || what instanceof CharacterStyle) {
      if (ims == null || ims.mBatchEditNesting == 0) {
        invalidate();
        mHighlightPathBogus = true;
        checkForResize();
      } else {
        ims.mContentChanged = true;
      }
      if (mEditor != null) {
        if (oldStart >= 0) mEditor.invalidateTextDisplayList(mLayout, oldStart, oldEnd);
        if (newStart >= 0) mEditor.invalidateTextDisplayList(mLayout, newStart, newEnd);
        mEditor.invalidateHandlesAndActionMode();
      }
    }

    if (MetaKeyKeyListener.isMetaTracker(buf, what)) {
      mHighlightPathBogus = true;
      if (ims != null && MetaKeyKeyListener.isSelectingMetaTracker(buf, what)) {
        ims.mSelectionModeChanged = true;
      }

      if (Selection.getSelectionStart(buf) >= 0) {
        if (ims == null || ims.mBatchEditNesting == 0) {
          invalidateCursor();
        } else {
          ims.mCursorChanged = true;
        }
      }
    }

    if (what instanceof ParcelableSpan) {
      // If this is a span that can be sent to a remote process,
      // the current extract editor would be interested in it.
      if (ims != null && ims.mExtractedTextRequest != null) {
        if (ims.mBatchEditNesting != 0) {
          if (oldStart >= 0) {
            if (ims.mChangedStart > oldStart) {
              ims.mChangedStart = oldStart;
            }
            if (ims.mChangedStart > oldEnd) {
              ims.mChangedStart = oldEnd;
            }
          }
          if (newStart >= 0) {
            if (ims.mChangedStart > newStart) {
              ims.mChangedStart = newStart;
            }
            if (ims.mChangedStart > newEnd) {
              ims.mChangedStart = newEnd;
            }
          }
        } else {
          if (DEBUG_EXTRACT) {
            Log.v(LOG_TAG, "Span change outside of batch: "
                           + oldStart + "-" + oldEnd + ","
                           + newStart + "-" + newEnd + " " + what);
          }
          ims.mContentChanged = true;
        }
      }
    }

    if (mEditor != null && mEditor.mSpellChecker != null && newStart < 0
        && what instanceof SpellCheckSpan) {
      mEditor.mSpellChecker.onSpellCheckSpanRemoved((SpellCheckSpan) what);
    }
  }

  @Override
  protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
    if (isTemporarilyDetached()) {
      // If we are temporarily in the detach state, then do nothing.
      super.onFocusChanged(focused, direction, previouslyFocusedRect);
      return;
    }

    mHideHint = false;

    if (mEditor != null) mEditor.onFocusChanged(focused, direction);

    if (focused) {
      if (mSpannable != null) {
        MetaKeyKeyListener.resetMetaState(mSpannable);
      }
    }

    startStopMarquee(focused);

    if (mTransformation != null) {
      mTransformation.onFocusChanged(this, mText, focused, direction, previouslyFocusedRect);
    }

    super.onFocusChanged(focused, direction, previouslyFocusedRect);
  }

  @Override
  public void onWindowFocusChanged(boolean hasWindowFocus) {
    super.onWindowFocusChanged(hasWindowFocus);

    if (mEditor != null) mEditor.onWindowFocusChanged(hasWindowFocus);

    startStopMarquee(hasWindowFocus);
  }

  @Override
  protected void onVisibilityChanged(View changedView, int visibility) {
    super.onVisibilityChanged(changedView, visibility);
    if (mEditor != null && visibility != VISIBLE) {
      mEditor.hideCursorAndSpanControllers();
      stopTextActionMode();
    }
  }

  @Override
  public void onVisibilityAggregated(boolean isVisible) {
    super.onVisibilityAggregated(isVisible);
    startStopMarquee(isVisible);
  }

  /**
   * Use {@link BaseInputConnection#removeComposingSpans
   * BaseInputConnection.removeComposingSpans()} to remove any IME composing
   * state from this text view.
   */
  public void clearComposingText() {
    if (mText instanceof Spannable) {
      BaseInputConnection.removeComposingSpans(mSpannable);
    }
  }

  @Override
  public void setSelected(boolean selected) {
    boolean wasSelected = isSelected();

    super.setSelected(selected);

    if (selected != wasSelected && mEllipsize == TextUtils.TruncateAt.MARQUEE) {
      if (selected) {
        startMarquee();
      } else {
        stopMarquee();
      }
    }
  }

  /**
   * Called from onTouchEvent() to prevent the touches by secondary fingers.
   * Dragging on handles can revise cursor/selection, so can dragging on the text view.
   * This method is a lock to avoid processing multiple fingers on both text view and handles.
   * Note: multiple fingers on handles (e.g. 2 fingers on the 2 selection handles) should work.
   *
   * @param event The motion event that is being handled and carries the pointer info.
   * @param fromHandleView true if the event is delivered to selection handle or insertion
   * handle; false if this event is delivered to TextView.
   * @return Returns true to indicate that onTouchEvent() can continue processing the motion
   * event, otherwise false.
   *  - Always returns true for the first finger.
   *  - For secondary fingers, if the first or current finger is from TextView, returns false.
   *    This is to make touch mutually exclusive between the TextView and the handles, but
   *    not among the handles.
   */
  boolean isFromPrimePointer(MotionEvent event, boolean fromHandleView) {
    boolean res = true;
    if (mPrimePointerId == NO_POINTER_ID)  {
      mPrimePointerId = event.getPointerId(0);
      mIsPrimePointerFromHandleView = fromHandleView;
    } else if (mPrimePointerId != event.getPointerId(0)) {
      res = mIsPrimePointerFromHandleView && fromHandleView;
    }
    if (event.getActionMasked() == MotionEvent.ACTION_UP
        || event.getActionMasked() == MotionEvent.ACTION_CANCEL) {
      mPrimePointerId = -1;
    }
    return res;
  }

  @Override
  public boolean onTouchEvent(MotionEvent event) {
    if (DEBUG_CURSOR) {
      logCursor("onTouchEvent", "%d: %s (%f,%f)",
                event.getSequenceNumber(),
                MotionEvent.actionToString(event.getActionMasked()),
                event.getX(), event.getY());
    }
    mLastInputSource = event.getSource();
    final int action = event.getActionMasked();
    if (mEditor != null) {
      if (!isFromPrimePointer(event, false)) {
        return true;
      }

      mEditor.onTouchEvent(event);

      if (mEditor.mInsertionPointCursorController != null
          && mEditor.mInsertionPointCursorController.isCursorBeingModified()) {
        return true;
      }
      if (mEditor.mSelectionModifierCursorController != null
          && mEditor.mSelectionModifierCursorController.isDragAcceleratorActive()) {
        return true;
      }
    }

    final boolean superResult = super.onTouchEvent(event);
    if (DEBUG_CURSOR) {
      logCursor("onTouchEvent", "superResult=%s", superResult);
    }

    /*
     * Don't handle the release after a long press, because it will move the selection away from
     * whatever the menu action was trying to affect. If the long press should have triggered an
     * insertion action mode, we can now actually show it.
     */
    if (mEditor != null && mEditor.mDiscardNextActionUp && action == MotionEvent.ACTION_UP) {
      mEditor.mDiscardNextActionUp = false;
      if (DEBUG_CURSOR) {
        logCursor("onTouchEvent", "release after long press detected");
      }
      if (mEditor.mIsInsertionActionModeStartPending) {
        mEditor.startInsertionActionMode();
        mEditor.mIsInsertionActionModeStartPending = false;
      }
      return superResult;
    }

    final boolean touchIsFinished = (action == MotionEvent.ACTION_UP)
                                    && (mEditor == null || !mEditor.mIgnoreActionUpEvent) && isFocused();

    if ((mMovement != null || onCheckIsTextEditor()) && isEnabled()
        && mText instanceof Spannable && mLayout != null) {
      boolean handled = false;

      if (mMovement != null) {
        handled |= mMovement.onTouchEvent(this, mSpannable, event);
      }

      final boolean textIsSelectable = isTextSelectable();
      if (touchIsFinished && mLinksClickable && mAutoLinkMask != 0 && textIsSelectable) {
        // The LinkMovementMethod which should handle taps on links has not been installed
        // on non editable text that support text selection.
        // We reproduce its behavior here to open links for these.
        ClickableSpan[] links = mSpannable.getSpans(getSelectionStart(),
                                                    getSelectionEnd(), ClickableSpan.class);

        if (links.length > 0) {
          links[0].onClick(this);
          handled = true;
        }
      }

      if (touchIsFinished && (isTextEditable() || textIsSelectable)) {
        // Show the IME, except when selecting in read-only text.
        final InputMethodManager imm = getInputMethodManager();
        viewClicked(imm);
        if (isTextEditable() && mEditor.mShowSoftInputOnFocus && imm != null
            && !showAutofillDialog()) {
          imm.showSoftInput(this, 0);
        }

        // The above condition ensures that the mEditor is not null
        mEditor.onTouchUpEvent(event);

        handled = true;
      }

      if (handled) {
        return true;
      }
    }

    return superResult;
  }

  /**
   * Returns true when need to show UIs, e.g. floating toolbar, etc, for finger based interaction.
   *
   * @return true if UIs need to show for finger interaciton. false if UIs are not necessary.
   * @hide
   */
  public final boolean showUIForTouchScreen() {
    return (mLastInputSource & InputDevice.SOURCE_TOUCHSCREEN)
           == InputDevice.SOURCE_TOUCHSCREEN;
  }

  /**
   * The fill dialog UI is a more conspicuous and efficient interface than dropdown UI.
   * If autofill suggestions are available when the user clicks on a field that supports filling
   * the dialog UI, Autofill will pop up a fill dialog. The dialog will take up a larger area
   * to display the datasets, so it is easy for users to pay attention to the datasets and
   * selecting a dataset. The autofill dialog is shown as the bottom sheet, the better
   * experience is not to show the IME if there is a fill dialog.
   */
  private boolean showAutofillDialog() {
    final AutofillManager afm = mContext.getSystemService(AutofillManager.class);
    if (afm != null) {
      return afm.showAutofillDialog(this);
    }
    return false;
  }

  @Override
  public boolean onGenericMotionEvent(MotionEvent event) {
    if (mMovement != null && mText instanceof Spannable && mLayout != null) {
      try {
        if (mMovement.onGenericMotionEvent(this, mSpannable, event)) {
          return true;
        }
      } catch (AbstractMethodError ex) {
        // onGenericMotionEvent was added to the MovementMethod interface in API 12.
        // Ignore its absence in case third party applications implemented the
        // interface directly.
      }
    }
    return super.onGenericMotionEvent(event);
  }

  @Override
  protected void onCreateContextMenu(ContextMenu menu) {
    if (mEditor != null) {
      mEditor.onCreateContextMenu(menu);
    }
  }

  @Override
  public boolean showContextMenu() {
    if (mEditor != null) {
      mEditor.setContextMenuAnchor(Float.NaN, Float.NaN);
    }
    return super.showContextMenu();
  }

  @Override
  public boolean showContextMenu(float x, float y) {
    if (mEditor != null) {
      mEditor.setContextMenuAnchor(x, y);
    }
    return super.showContextMenu(x, y);
  }

  /**
   * @return True iff this TextView contains a text that can be edited, or if this is
   * a selectable TextView.
   */
  @UnsupportedAppUsage
  boolean isTextEditable() {
    return mText instanceof Editable && onCheckIsTextEditor() && isEnabled();
  }

  /**
   * @return true if this TextView could be filled by an Autofill service. Note that disabled
   * fields can still be filled.
   */
  @UnsupportedAppUsage
  boolean isTextAutofillable() {
    return mText instanceof Editable && onCheckIsTextEditor();
  }

  /**
   * Returns true, only while processing a touch gesture, if the initial
   * touch down event caused focus to move to the text view and as a result
   * its selection changed.  Only valid while processing the touch gesture
   * of interest, in an editable text view.
   */
  public boolean didTouchFocusSelect() {
    return mEditor != null && mEditor.mTouchFocusSelected;
  }

  @Override
  public void cancelLongPress() {
    super.cancelLongPress();
    if (mEditor != null) mEditor.mIgnoreActionUpEvent = true;
  }

  @Override
  public boolean onTrackballEvent(MotionEvent event) {
    if (mMovement != null && mSpannable != null && mLayout != null) {
      if (mMovement.onTrackballEvent(this, mSpannable, event)) {
        return true;
      }
    }

    return super.onTrackballEvent(event);
  }

  /**
   * Sets the Scroller used for producing a scrolling animation
   *
   * @param s A Scroller instance
   */
  public void setScroller(Scroller s) {
    mScroller = s;
  }

  @Override
  protected float getLeftFadingEdgeStrength() {
    if (isMarqueeFadeEnabled() && mMarquee != null && !mMarquee.isStopped()) {
      final Marquee marquee = mMarquee;
      if (marquee.shouldDrawLeftFade()) {
        return getHorizontalFadingEdgeStrength(marquee.getScroll(), 0.0f);
      } else {
        return 0.0f;
      }
    } else if (getLineCount() == 1) {
      final float lineLeft = getLayout().getLineLeft(0);
      if (lineLeft > mScrollX) return 0.0f;
      return getHorizontalFadingEdgeStrength(mScrollX, lineLeft);
    }
    return super.getLeftFadingEdgeStrength();
  }

  @Override
  protected float getRightFadingEdgeStrength() {
    if (isMarqueeFadeEnabled() && mMarquee != null && !mMarquee.isStopped()) {
      final Marquee marquee = mMarquee;
      return getHorizontalFadingEdgeStrength(marquee.getMaxFadeScroll(), marquee.getScroll());
    } else if (getLineCount() == 1) {
      final float rightEdge = mScrollX +
                              (getWidth() - getCompoundPaddingLeft() - getCompoundPaddingRight());
      final float lineRight = getLayout().getLineRight(0);
      if (lineRight < rightEdge) return 0.0f;
      return getHorizontalFadingEdgeStrength(rightEdge, lineRight);
    }
    return super.getRightFadingEdgeStrength();
  }

  /**
   * Calculates the fading edge strength as the ratio of the distance between two
   * horizontal positions to {@link View#getHorizontalFadingEdgeLength()}. Uses the absolute
   * value for the distance calculation.
   *
   * @param position1 A horizontal position.
   * @param position2 A horizontal position.
   * @return Fading edge strength between [0.0f, 1.0f].
   */
  @FloatRange(from = 0.0, to = 1.0)
  private float getHorizontalFadingEdgeStrength(float position1, float position2) {
    final int horizontalFadingEdgeLength = getHorizontalFadingEdgeLength();
    if (horizontalFadingEdgeLength == 0) return 0.0f;
    final float diff = Math.abs(position1 - position2);
    if (diff > horizontalFadingEdgeLength) return 1.0f;
    return diff / horizontalFadingEdgeLength;
  }

  private boolean isMarqueeFadeEnabled() {
    return mEllipsize == TextUtils.TruncateAt.MARQUEE
           && mMarqueeFadeMode != MARQUEE_FADE_SWITCH_SHOW_ELLIPSIS;
  }

  @Override
  protected int computeHorizontalScrollRange() {
    if (mLayout != null) {
      return mSingleLine && (mGravity & Gravity.HORIZONTAL_GRAVITY_MASK) == Gravity.LEFT
             ? (int) mLayout.getLineWidth(0) : mLayout.getWidth();
    }

    return super.computeHorizontalScrollRange();
  }

  @Override
  protected int computeVerticalScrollRange() {
    if (mLayout != null) {
      return mLayout.getHeight();
    }
    return super.computeVerticalScrollRange();
  }

  @Override
  protected int computeVerticalScrollExtent() {
    return getHeight() - getCompoundPaddingTop() - getCompoundPaddingBottom();
  }

  @Override
  public void findViewsWithText(ArrayList<View> outViews, CharSequence searched, int flags) {
    super.findViewsWithText(outViews, searched, flags);
    if (!outViews.contains(this) && (flags & FIND_VIEWS_WITH_TEXT) != 0
        && !TextUtils.isEmpty(searched) && !TextUtils.isEmpty(mText)) {
      String searchedLowerCase = searched.toString().toLowerCase();
      String textLowerCase = mText.toString().toLowerCase();
      if (textLowerCase.contains(searchedLowerCase)) {
        outViews.add(this);
      }
    }
  }

  /**
   * Type of the text buffer that defines the characteristics of the text such as static,
   * styleable, or editable.
   */
  public enum BufferType {
    NORMAL, SPANNABLE, EDITABLE
  }

  /**
   * Returns the TextView_textColor attribute from the TypedArray, if set, or
   * the TextAppearance_textColor from the TextView_textAppearance attribute,
   * if TextView_textColor was not set directly.
   *
   * @removed
   */
  public static ColorStateList getTextColors(Context context, TypedArray attrs) {
    if (attrs == null) {
      // Preserve behavior prior to removal of this API.
      throw new NullPointerException();
    }

    // It's not safe to use this method from apps. The parameter 'attrs'
    // must have been obtained using the TextView filter array which is not
    // available to the SDK. As such, we grab a default TypedArray with the
    // right filter instead here.
    final TypedArray a = context.obtainStyledAttributes(R.styleable.TextView);
    ColorStateList colors = a.getColorStateList(R.styleable.TextView_textColor);
    if (colors == null) {
      final int ap = a.getResourceId(R.styleable.TextView_textAppearance, 0);
      if (ap != 0) {
        final TypedArray appearance = context.obtainStyledAttributes(
          ap, R.styleable.TextAppearance);
        colors = appearance.getColorStateList(R.styleable.TextAppearance_textColor);
        appearance.recycle();
      }
    }
    a.recycle();

    return colors;
  }

  /**
   * Returns the default color from the TextView_textColor attribute from the
   * AttributeSet, if set, or the default color from the
   * TextAppearance_textColor from the TextView_textAppearance attribute, if
   * TextView_textColor was not set directly.
   *
   * @removed
   */
  public static int getTextColor(Context context, TypedArray attrs, int def) {
    final ColorStateList colors = getTextColors(context, attrs);
    if (colors == null) {
      return def;
    } else {
      return colors.getDefaultColor();
    }
  }

  @Override
  public boolean onKeyShortcut(int keyCode, KeyEvent event) {
    if (event.hasModifiers(KeyEvent.META_CTRL_ON)) {
      // Handle Ctrl-only shortcuts.
      switch (keyCode) {
        case KeyEvent.KEYCODE_A:
          if (canSelectText()) {
            return onTextContextMenuItem(ID_SELECT_ALL);
          }
          break;
        case KeyEvent.KEYCODE_Z:
          if (canUndo()) {
            return onTextContextMenuItem(ID_UNDO);
          }
          break;
        case KeyEvent.KEYCODE_X:
          if (canCut()) {
            return onTextContextMenuItem(ID_CUT);
          }
          break;
        case KeyEvent.KEYCODE_C:
          if (canCopy()) {
            return onTextContextMenuItem(ID_COPY);
          }
          break;
        case KeyEvent.KEYCODE_V:
          if (canPaste()) {
            return onTextContextMenuItem(ID_PASTE);
          }
          break;
        case KeyEvent.KEYCODE_Y:
          if (canRedo()) {
            return onTextContextMenuItem(ID_REDO);
          }
          break;
      }
    } else if (event.hasModifiers(KeyEvent.META_CTRL_ON | KeyEvent.META_SHIFT_ON)) {
      // Handle Ctrl-Shift shortcuts.
      switch (keyCode) {
        case KeyEvent.KEYCODE_Z:
          if (canRedo()) {
            return onTextContextMenuItem(ID_REDO);
          }
          break;
        case KeyEvent.KEYCODE_V:
          if (canPaste()) {
            return onTextContextMenuItem(ID_PASTE_AS_PLAIN_TEXT);
          }
      }
    }
    return super.onKeyShortcut(keyCode, event);
  }

  /**
   * Unlike {@link #textCanBeSelected()}, this method is based on the <i>current</i> state of the
   * TextView. {@link #textCanBeSelected()} has to be true (this is one of the conditions to have
   * a selection controller (see {@link Editor#prepareCursorControllers()}), but this is not
   * sufficient.
   */
  boolean canSelectText() {
    return mText.length() != 0 && mEditor != null && mEditor.hasSelectionController();
  }

  /**
   * Test based on the <i>intrinsic</i> charateristics of the TextView.
   * The text must be spannable and the movement method must allow for arbitary selection.
   *
   * See also {@link #canSelectText()}.
   */
  boolean textCanBeSelected() {
    // prepareCursorController() relies on this method.
    // If you change this condition, make sure prepareCursorController is called anywhere
    // the value of this condition might be changed.
    if (mMovement == null || !mMovement.canSelectArbitrarily()) return false;
    return isTextEditable()
           || (isTextSelectable() && mText instanceof Spannable && isEnabled());
  }

  @UnsupportedAppUsage
  private Locale getTextServicesLocale(boolean allowNullLocale) {
    // Start fetching the text services locale asynchronously.
    updateTextServicesLocaleAsync();
    // If !allowNullLocale and there is no cached text services locale, just return the default
    // locale.
    return (mCurrentSpellCheckerLocaleCache == null && !allowNullLocale) ? Locale.getDefault()
                                                                         : mCurrentSpellCheckerLocaleCache;
  }

  /**
   * Associate {@link UserHandle} who is considered to be the logical owner of the text shown in
   * this {@link TextView}.
   *
   * <p>Most of applications should not worry about this.  Some privileged apps that host UI for
   * other apps may need to set this so that the system can user right user's resources and
   * services such as input methods and spell checkers.</p>
   *
   * @param user {@link UserHandle} who is considered to be the owner of the text shown in this
   *        {@link TextView}. {@code null} to reset {@link #mTextOperationUser}.
   * @hide
   */
  @RequiresPermission(INTERACT_ACROSS_USERS_FULL)
  public final void setTextOperationUser(@Nullable UserHandle user) {
    if (Objects.equals(mTextOperationUser, user)) {
      return;
    }
    if (user != null && !Process.myUserHandle().equals(user)) {
      // Just for preventing people from accidentally using this hidden API without
      // the required permission.  The same permission is also checked in the system server.
      if (getContext().checkSelfPermission(INTERACT_ACROSS_USERS_FULL)
          != PackageManager.PERMISSION_GRANTED) {
        throw new SecurityException("INTERACT_ACROSS_USERS_FULL is required."
                                    + " userId=" + user.getIdentifier()
                                    + " callingUserId" + UserHandle.myUserId());
      }
    }
    mTextOperationUser = user;
    // Invalidate some resources
    mCurrentSpellCheckerLocaleCache = null;
    if (mEditor != null) {
      mEditor.onTextOperationUserChanged();
    }
  }

  @Override
  public boolean isAutoHandwritingEnabled() {
    return super.isAutoHandwritingEnabled() && !isAnyPasswordInputType();
  }

  /** @hide */
  @Override
  public boolean isStylusHandwritingAvailable() {
    if (mTextOperationUser == null) {
      return super.isStylusHandwritingAvailable();
    }
    final InputMethodManager imm = getInputMethodManager();
    return imm.isStylusHandwritingAvailableAsUser(mTextOperationUser);
  }

  @Nullable
  final TextServicesManager getTextServicesManagerForUser() {
    return getServiceManagerForUser("android", TextServicesManager.class);
  }

  @Nullable
  final ClipboardManager getClipboardManagerForUser() {
    return getServiceManagerForUser(getContext().getPackageName(), ClipboardManager.class);
  }

  @Nullable
  final TextClassificationManager getTextClassificationManagerForUser() {
    return getServiceManagerForUser(
      getContext().getPackageName(), TextClassificationManager.class);
  }

  @Nullable
  final <T> T getServiceManagerForUser(String packageName, Class<T> managerClazz) {
    if (mTextOperationUser == null) {
      return getContext().getSystemService(managerClazz);
    }
    try {
      Context context = getContext().createPackageContextAsUser(
        packageName, 0 /* flags */, mTextOperationUser);
      return context.getSystemService(managerClazz);
    } catch (PackageManager.NameNotFoundException e) {
      return null;
    }
  }

  /**
   * Starts {@link Activity} as a text-operation user if it is specified with
   * {@link #setTextOperationUser(UserHandle)}.
   *
   * <p>Otherwise, just starts {@link Activity} with {@link Context#startActivity(Intent)}.</p>
   *
   * @param intent The description of the activity to start.
   */
  void startActivityAsTextOperationUserIfNecessary(@NonNull Intent intent) {
    if (mTextOperationUser != null) {
      getContext().startActivityAsUser(intent, mTextOperationUser);
    } else {
      getContext().startActivity(intent);
    }
  }

  /**
   * This is a temporary method. Future versions may support multi-locale text.
   * Caveat: This method may not return the latest text services locale, but this should be
   * acceptable and it's more important to make this method asynchronous.
   *
   * @return The locale that should be used for a word iterator
   * in this TextView, based on the current spell checker settings,
   * the current IME's locale, or the system default locale.
   * Please note that a word iterator in this TextView is different from another word iterator
   * used by SpellChecker.java of TextView. This method should be used for the former.
   * @hide
   */
  // TODO: Support multi-locale
  // TODO: Update the text services locale immediately after the keyboard locale is switched
  // by catching intent of keyboard switch event
  public Locale getTextServicesLocale() {
    return getTextServicesLocale(false /* allowNullLocale */);
  }

  /**
   * @return {@code true} if this TextView is specialized for showing and interacting with the
   * extracted text in a full-screen input method.
   * @hide
   */
  public boolean isInExtractedMode() {
    return false;
  }

  /**
   * @return {@code true} if this widget supports auto-sizing text and has been configured to
   * auto-size.
   */
  private boolean isAutoSizeEnabled() {
    return supportsAutoSizeText() && mAutoSizeTextType != AUTO_SIZE_TEXT_TYPE_NONE;
  }

  /**
   * @return {@code true} if this TextView supports auto-sizing text to fit within its container.
   * @hide
   */
  protected boolean supportsAutoSizeText() {
    return true;
  }

  /**
   * This is a temporary method. Future versions may support multi-locale text.
   * Caveat: This method may not return the latest spell checker locale, but this should be
   * acceptable and it's more important to make this method asynchronous.
   *
   * @return The locale that should be used for a spell checker in this TextView,
   * based on the current spell checker settings, the current IME's locale, or the system default
   * locale.
   * @hide
   */
  public Locale getSpellCheckerLocale() {
    return getTextServicesLocale(true /* allowNullLocale */);
  }

  private void updateTextServicesLocaleAsync() {
    // AsyncTask.execute() uses a serial executor which means we don't have
    // to lock around updateTextServicesLocaleLocked() to prevent it from
    // being executed n times in parallel.
    AsyncTask.execute(new Runnable() {
      @Override
      public void run() {
        updateTextServicesLocaleLocked();
      }
    });
  }

  @UnsupportedAppUsage
  private void updateTextServicesLocaleLocked() {
    final TextServicesManager textServicesManager = getTextServicesManagerForUser();
    if (textServicesManager == null) {
      return;
    }
    final SpellCheckerSubtype subtype = textServicesManager.getCurrentSpellCheckerSubtype(true);
    final Locale locale;
    if (subtype != null) {
      locale = subtype.getLocaleObject();
    } else {
      locale = null;
    }
    mCurrentSpellCheckerLocaleCache = locale;
  }

  void onLocaleChanged() {
    mEditor.onLocaleChanged();
  }

  /**
   * This method is used by the ArrowKeyMovementMethod to jump from one word to the other.
   * Made available to achieve a consistent behavior.
   * @hide
   */
  public WordIterator getWordIterator() {
    if (mEditor != null) {
      return mEditor.getWordIterator();
    } else {
      return null;
    }
  }

  /** @hide */
  @Override
  public void onPopulateAccessibilityEventInternal(AccessibilityEvent event) {
    super.onPopulateAccessibilityEventInternal(event);

    if (this.isAccessibilityDataSensitive() && !event.isAccessibilityDataSensitive()) {
      // This view's accessibility data is sensitive, but another view that generated this
      // event is not, so don't append this view's text to the event in order to prevent
      // sharing this view's contents with non-accessibility-tool services.
      return;
    }

    final CharSequence text = getTextForAccessibility();
    if (!TextUtils.isEmpty(text)) {
      event.getText().add(text);
    }
  }

  @Override
  public CharSequence getAccessibilityClassName() {
    return TextView.class.getName();
  }

  /** @hide */
  @Override
  protected void onProvideStructure(@NonNull ViewStructure structure,
                                    @ViewStructureType int viewFor, int flags) {
    super.onProvideStructure(structure, viewFor, flags);

    final boolean isPassword = hasPasswordTransformationMethod()
                               || isPasswordInputType(getInputType());
    if (viewFor == VIEW_STRUCTURE_FOR_AUTOFILL
        || viewFor == VIEW_STRUCTURE_FOR_CONTENT_CAPTURE) {
      if (viewFor == VIEW_STRUCTURE_FOR_AUTOFILL) {
        structure.setDataIsSensitive(!mTextSetFromXmlOrResourceId);
      }
      if (mTextId != Resources.ID_NULL) {
        try {
          structure.setTextIdEntry(getResources().getResourceEntryName(mTextId));
        } catch (Resources.NotFoundException e) {
          if (android.view.autofill.Helper.sVerbose) {
            Log.v(LOG_TAG, "onProvideAutofillStructure(): cannot set name for text id "
                           + mTextId + ": " + e.getMessage());
          }
        }
      }
      String[] mimeTypes = getReceiveContentMimeTypes();
      if (mimeTypes == null && mEditor != null) {
        // If the app hasn't set a listener for receiving content on this view (ie,
        // getReceiveContentMimeTypes() returns null), check if it implements the
        // keyboard image API and, if possible, use those MIME types as fallback.
        // This fallback is only in place for autofill, not other mechanisms for
        // inserting content. See AUTOFILL_NON_TEXT_REQUIRES_ON_RECEIVE_CONTENT_LISTENER
        // in TextViewOnReceiveContentListener for more info.
        mimeTypes = mEditor.getDefaultOnReceiveContentListener()
          .getFallbackMimeTypesForAutofill(this);
      }
      structure.setReceiveContentMimeTypes(mimeTypes);
    }

    if (!isPassword || viewFor == VIEW_STRUCTURE_FOR_AUTOFILL
        || viewFor == VIEW_STRUCTURE_FOR_CONTENT_CAPTURE) {
      if (mLayout == null) {
        if (viewFor == VIEW_STRUCTURE_FOR_CONTENT_CAPTURE) {
          Log.w(LOG_TAG, "onProvideContentCaptureStructure(): calling assumeLayout()");
        }
        assumeLayout();
      }
      Layout layout = mLayout;
      final int lineCount = layout.getLineCount();
      if (lineCount <= 1) {
        // Simple case: this is a single line.
        final CharSequence text = getText();
        if (viewFor == VIEW_STRUCTURE_FOR_AUTOFILL) {
          structure.setText(text);
        } else {
          structure.setText(text, getSelectionStart(), getSelectionEnd());
        }
      } else {
        // Complex case: multi-line, could be scrolled or within a scroll container
        // so some lines are not visible.
        final int[] tmpCords = new int[2];
        getLocationInWindow(tmpCords);
        final int topWindowLocation = tmpCords[1];
        View root = this;
        ViewParent viewParent = getParent();
        while (viewParent instanceof View) {
          root = (View) viewParent;
          viewParent = root.getParent();
        }
        final int windowHeight = root.getHeight();
        final int topLine;
        final int bottomLine;
        if (topWindowLocation >= 0) {
          // The top of the view is fully within its window; start text at line 0.
          topLine = getLineAtCoordinateUnclamped(0);
          bottomLine = getLineAtCoordinateUnclamped(windowHeight - 1);
        } else {
          // The top of hte window has scrolled off the top of the window; figure out
          // the starting line for this.
          topLine = getLineAtCoordinateUnclamped(-topWindowLocation);
          bottomLine = getLineAtCoordinateUnclamped(windowHeight - 1 - topWindowLocation);
        }
        // We want to return some contextual lines above/below the lines that are
        // actually visible.
        int expandedTopLine = topLine - (bottomLine - topLine) / 2;
        if (expandedTopLine < 0) {
          expandedTopLine = 0;
        }
        int expandedBottomLine = bottomLine + (bottomLine - topLine) / 2;
        if (expandedBottomLine >= lineCount) {
          expandedBottomLine = lineCount - 1;
        }

        // Convert lines into character offsets.
        int expandedTopChar = transformedToOriginal(
          layout.getLineStart(expandedTopLine),
          OffsetMapping.MAP_STRATEGY_CHARACTER);
        int expandedBottomChar = transformedToOriginal(
          layout.getLineEnd(expandedBottomLine),
          OffsetMapping.MAP_STRATEGY_CHARACTER);

        // Take into account selection -- if there is a selection, we need to expand
        // the text we are returning to include that selection.
        final int selStart = getSelectionStart();
        final int selEnd = getSelectionEnd();
        if (selStart < selEnd) {
          if (selStart < expandedTopChar) {
            expandedTopChar = selStart;
          }
          if (selEnd > expandedBottomChar) {
            expandedBottomChar = selEnd;
          }
        }

        // Get the text and trim it to the range we are reporting.
        CharSequence text = getText();

        if (text != null) {
          if (expandedTopChar > 0 || expandedBottomChar < text.length()) {
            // Cap the offsets to avoid an OOB exception. That can happen if the
            // displayed/layout text, on which these offsets are calculated, is longer
            // than the original text (such as when the view is translated by the
            // platform intelligence).
            // TODO(b/196433694): Figure out how to better handle the offset
            // calculations for this case (so we don't unnecessarily cutoff the original
            // text, for example).
            expandedTopChar = Math.min(expandedTopChar, text.length());
            expandedBottomChar = Math.min(expandedBottomChar, text.length());
            text = text.subSequence(expandedTopChar, expandedBottomChar);
          }

          if (viewFor == VIEW_STRUCTURE_FOR_AUTOFILL) {
            structure.setText(text);
          } else {
            structure.setText(text,
                              selStart - expandedTopChar,
                              selEnd - expandedTopChar);

            final int[] lineOffsets = new int[bottomLine - topLine + 1];
            final int[] lineBaselines = new int[bottomLine - topLine + 1];
            final int baselineOffset = getBaselineOffset();
            for (int i = topLine; i <= bottomLine; i++) {
              lineOffsets[i - topLine] = transformedToOriginal(layout.getLineStart(i),
                                                               OffsetMapping.MAP_STRATEGY_CHARACTER);
              lineBaselines[i - topLine] =
                layout.getLineBaseline(i) + baselineOffset;
            }
            structure.setTextLines(lineOffsets, lineBaselines);
          }
        }
      }

      if (viewFor == VIEW_STRUCTURE_FOR_ASSIST
          || viewFor == VIEW_STRUCTURE_FOR_CONTENT_CAPTURE) {
        // Extract style information that applies to the TextView as a whole.
        int style = 0;
        int typefaceStyle = getTypefaceStyle();
        if ((typefaceStyle & Typeface.BOLD) != 0) {
          style |= AssistStructure.ViewNode.TEXT_STYLE_BOLD;
        }
        if ((typefaceStyle & Typeface.ITALIC) != 0) {
          style |= AssistStructure.ViewNode.TEXT_STYLE_ITALIC;
        }

        // Global styles can also be set via TextView.setPaintFlags().
        int paintFlags = mTextPaint.getFlags();
        if ((paintFlags & Paint.FAKE_BOLD_TEXT_FLAG) != 0) {
          style |= AssistStructure.ViewNode.TEXT_STYLE_BOLD;
        }
        if ((paintFlags & Paint.UNDERLINE_TEXT_FLAG) != 0) {
          style |= AssistStructure.ViewNode.TEXT_STYLE_UNDERLINE;
        }
        if ((paintFlags & Paint.STRIKE_THRU_TEXT_FLAG) != 0) {
          style |= AssistStructure.ViewNode.TEXT_STYLE_STRIKE_THRU;
        }

        // TextView does not have its own text background color. A background is either part
        // of the View (and can be any drawable) or a BackgroundColorSpan inside the text.
        structure.setTextStyle(getTextSize(), getCurrentTextColor(),
                               AssistStructure.ViewNode.TEXT_COLOR_UNDEFINED /* bgColor */, style);
      }
      if (viewFor == VIEW_STRUCTURE_FOR_AUTOFILL
          || viewFor == VIEW_STRUCTURE_FOR_CONTENT_CAPTURE) {
        structure.setMinTextEms(getMinEms());
        structure.setMaxTextEms(getMaxEms());
        int maxLength = -1;
        for (InputFilter filter: getFilters()) {
          if (filter instanceof InputFilter.LengthFilter) {
            maxLength = ((InputFilter.LengthFilter) filter).getMax();
            break;
          }
        }
        structure.setMaxTextLength(maxLength);
      }
    }
    if (mHintId != Resources.ID_NULL) {
      try {
        structure.setHintIdEntry(getResources().getResourceEntryName(mHintId));
      } catch (Resources.NotFoundException e) {
        if (android.view.autofill.Helper.sVerbose) {
          Log.v(LOG_TAG, "onProvideAutofillStructure(): cannot set name for hint id "
                         + mHintId + ": " + e.getMessage());
        }
      }
    }
    structure.setHint(getHint());
    structure.setInputType(getInputType());
  }

  boolean canRequestAutofill() {
    if (!isAutofillable()) {
      return false;
    }
    final AutofillManager afm = mContext.getSystemService(AutofillManager.class);
    if (afm != null) {
      return afm.isEnabled();
    }
    return false;
  }

  private void requestAutofill() {
    final AutofillManager afm = mContext.getSystemService(AutofillManager.class);
    if (afm != null) {
      afm.requestAutofill(this);
    }
  }

  @Override
  public void autofill(AutofillValue value) {
    if (!isTextAutofillable()) {
      Log.w(LOG_TAG, "cannot autofill non-editable TextView: " + this);
      return;
    }
    if (!value.isText()) {
      Log.w(LOG_TAG, "value of type " + value.describeContents()
                     + " cannot be autofilled into " + this);
      return;
    }
    final ClipData clip = ClipData.newPlainText("", value.getTextValue());
    final ContentInfo payload = new ContentInfo.Builder(clip, SOURCE_AUTOFILL).build();
    performReceiveContent(payload);
  }

  @Override
  public @AutofillType int getAutofillType() {
    return isTextAutofillable() ? AUTOFILL_TYPE_TEXT : AUTOFILL_TYPE_NONE;
  }

  /**
   * Gets the {@link TextView}'s current text for AutoFill. The value is trimmed to 100K
   * {@code char}s if longer.
   *
   * @return current text, {@code null} if the text is not editable
   *
   * @see View#getAutofillValue()
   */
  @Override
  @Nullable
  public AutofillValue getAutofillValue() {
    if (isTextAutofillable()) {
      final CharSequence text = TextUtils.trimToParcelableSize(getText());
      return AutofillValue.forText(text);
    }
    return null;
  }

  /** @hide */
  @Override
  public void onInitializeAccessibilityEventInternal(AccessibilityEvent event) {
    super.onInitializeAccessibilityEventInternal(event);

    final boolean isPassword = hasPasswordTransformationMethod();
    event.setPassword(isPassword);

    if (event.getEventType() == AccessibilityEvent.TYPE_VIEW_TEXT_SELECTION_CHANGED) {
      event.setFromIndex(Selection.getSelectionStart(mText));
      event.setToIndex(Selection.getSelectionEnd(mText));
      event.setItemCount(mText.length());
    }
  }

  /** @hide */
  @Override
  public void onInitializeAccessibilityNodeInfoInternal(AccessibilityNodeInfo info) {
    super.onInitializeAccessibilityNodeInfoInternal(info);

    final boolean isPassword = hasPasswordTransformationMethod();
    info.setPassword(isPassword);
    info.setText(getTextForAccessibility());
    info.setHintText(mHint);
    info.setShowingHintText(isShowingHint());

    if (mBufferType == BufferType.EDITABLE) {
      info.setEditable(true);
      if (isEnabled()) {
        info.addAction(AccessibilityNodeInfo.AccessibilityAction.ACTION_SET_TEXT);
      }
    }

    if (mEditor != null) {
      info.setInputType(mEditor.mInputType);

      if (mEditor.mError != null) {
        info.setContentInvalid(true);
        info.setError(mEditor.mError);
      }
      // TextView will expose this action if it is editable and has focus.
      if (isTextEditable() && isFocused()) {
        CharSequence imeActionLabel = mContext.getResources().getString(
          com.android.internal.R.string.keyboardview_keycode_enter);
        if (getImeActionLabel() != null) {
          imeActionLabel = getImeActionLabel();
        }
        AccessibilityNodeInfo.AccessibilityAction action =
          new AccessibilityNodeInfo.AccessibilityAction(
            R.id.accessibilityActionImeEnter, imeActionLabel);
        info.addAction(action);
      }
    }

    if (!TextUtils.isEmpty(mText)) {
      info.addAction(AccessibilityNodeInfo.ACTION_NEXT_AT_MOVEMENT_GRANULARITY);
      info.addAction(AccessibilityNodeInfo.ACTION_PREVIOUS_AT_MOVEMENT_GRANULARITY);
      info.setMovementGranularities(AccessibilityNodeInfo.MOVEMENT_GRANULARITY_CHARACTER
                                    | AccessibilityNodeInfo.MOVEMENT_GRANULARITY_WORD
                                    | AccessibilityNodeInfo.MOVEMENT_GRANULARITY_LINE
                                    | AccessibilityNodeInfo.MOVEMENT_GRANULARITY_PARAGRAPH
                                    | AccessibilityNodeInfo.MOVEMENT_GRANULARITY_PAGE);
      info.addAction(AccessibilityNodeInfo.ACTION_SET_SELECTION);
      info.setAvailableExtraData(Arrays.asList(
        EXTRA_DATA_RENDERING_INFO_KEY,
        EXTRA_DATA_TEXT_CHARACTER_LOCATION_KEY
      ));
      info.setTextSelectable(isTextSelectable() || isTextEditable());
    } else {
      info.setAvailableExtraData(Arrays.asList(
        EXTRA_DATA_RENDERING_INFO_KEY
      ));
    }

    if (isFocused()) {
      if (canCopy()) {
        info.addAction(AccessibilityNodeInfo.ACTION_COPY);
      }
      if (canPaste()) {
        info.addAction(AccessibilityNodeInfo.ACTION_PASTE);
      }
      if (canCut()) {
        info.addAction(AccessibilityNodeInfo.ACTION_CUT);
      }
      if (canReplace()) {
        info.addAction(
          AccessibilityNodeInfo.AccessibilityAction.ACTION_SHOW_TEXT_SUGGESTIONS);
      }
      if (canShare()) {
        info.addAction(new AccessibilityNodeInfo.AccessibilityAction(
          ACCESSIBILITY_ACTION_SHARE,
          getResources().getString(com.android.internal.R.string.share)));
      }
      if (canProcessText()) {  // also implies mEditor is not null.
        mEditor.mProcessTextIntentActionsHandler.onInitializeAccessibilityNodeInfo(info);
        mEditor.onInitializeSmartActionsAccessibilityNodeInfo(info);
      }
    }

    // Check for known input filter types.
    final int numFilters = mFilters.length;
    for (int i = 0; i < numFilters; i++) {
      final InputFilter filter = mFilters[i];
      if (filter instanceof InputFilter.LengthFilter) {
        info.setMaxTextLength(((InputFilter.LengthFilter) filter).getMax());
      }
    }

    if (!isSingleLine()) {
      info.setMultiLine(true);
    }

    // A view should not be exposed as clickable/long-clickable to a service because of a
    // LinkMovementMethod or because it has selectable and non-editable text.
    if ((info.isClickable() || info.isLongClickable())
        && (mMovement instanceof LinkMovementMethod
            || (isTextSelectable() && !isTextEditable()))) {
      if (!hasOnClickListeners()) {
        info.setClickable(false);
        info.removeAction(AccessibilityNodeInfo.AccessibilityAction.ACTION_CLICK);
      }
      if (!hasOnLongClickListeners()) {
        info.setLongClickable(false);
        info.removeAction(AccessibilityNodeInfo.AccessibilityAction.ACTION_LONG_CLICK);
      }
    }
  }

  @Override
  public void addExtraDataToAccessibilityNodeInfo(
    AccessibilityNodeInfo info, String extraDataKey, Bundle arguments) {
    if (arguments != null && extraDataKey.equals(EXTRA_DATA_TEXT_CHARACTER_LOCATION_KEY)) {
      int positionInfoStartIndex = arguments.getInt(
        EXTRA_DATA_TEXT_CHARACTER_LOCATION_ARG_START_INDEX, -1);
      int positionInfoLength = arguments.getInt(
        EXTRA_DATA_TEXT_CHARACTER_LOCATION_ARG_LENGTH, -1);
      if ((positionInfoLength <= 0) || (positionInfoStartIndex < 0)
          || (positionInfoStartIndex >= mText.length())) {
        Log.e(LOG_TAG, "Invalid arguments for accessibility character locations");
        return;
      }
      RectF[] boundingRects = new RectF[positionInfoLength];
      final CursorAnchorInfo.Builder builder = new CursorAnchorInfo.Builder();
      populateCharacterBounds(builder, positionInfoStartIndex,
                              Math.min(positionInfoStartIndex + positionInfoLength, length()),
                              viewportToContentHorizontalOffset(), viewportToContentVerticalOffset());
      CursorAnchorInfo cursorAnchorInfo = builder.setMatrix(null).build();
      for (int i = 0; i < positionInfoLength; i++) {
        int flags = cursorAnchorInfo.getCharacterBoundsFlags(positionInfoStartIndex + i);
        if ((flags & FLAG_HAS_VISIBLE_REGION) == FLAG_HAS_VISIBLE_REGION) {
          RectF bounds = cursorAnchorInfo
            .getCharacterBounds(positionInfoStartIndex + i);
          if (bounds != null) {
            mapRectFromViewToScreenCoords(bounds, true);
            boundingRects[i] = bounds;
          }
        }
      }
      info.getExtras().putParcelableArray(extraDataKey, boundingRects);
      return;
    }
    if (extraDataKey.equals(AccessibilityNodeInfo.EXTRA_DATA_RENDERING_INFO_KEY)) {
      final AccessibilityNodeInfo.ExtraRenderingInfo extraRenderingInfo =
        AccessibilityNodeInfo.ExtraRenderingInfo.obtain();
      extraRenderingInfo.setLayoutSize(getLayoutParams().width, getLayoutParams().height);
      extraRenderingInfo.setTextSizeInPx(getTextSize());
      extraRenderingInfo.setTextSizeUnit(getTextSizeUnit());
      info.setExtraRenderingInfo(extraRenderingInfo);
    }
  }

  /**
   * Helper method to set {@code rect} to this TextView's non-clipped area in its own coordinates.
   * This method obtains the view's visible rectangle whereas the method
   * {@link #getContentVisibleRect} returns the text layout's visible rectangle.
   *
   * @return true if at least part of the text content is visible; false if the text content is
   * completely clipped or translated out of the visible area.
   */
  private boolean getViewVisibleRect(Rect rect) {
    if (!getLocalVisibleRect(rect)) {
      return false;
    }
    // getLocalVisibleRect returns a rect relative to the unscrolled left top corner of the
    // view. In other words, the returned rectangle's origin point is (-scrollX, -scrollY) in
    // view's coordinates. So we need to offset it with the negative scrolled amount to convert
    // it to view's coordinate.
    rect.offset(-getScrollX(), -getScrollY());
    return true;
  }

  /**
   * Helper method to set {@code rect} to the text content's non-clipped area in the view's
   * coordinates.
   *
   * @return true if at least part of the text content is visible; false if the text content is
   * completely clipped or translated out of the visible area.
   */
  private boolean getContentVisibleRect(Rect rect) {
    if (!getViewVisibleRect(rect)) {
      return false;
    }
    // Clip the view's visible rect with the text layout's visible rect.
    return rect.intersect(getCompoundPaddingLeft(), getCompoundPaddingTop(),
                          getWidth() - getCompoundPaddingRight(), getHeight() - getCompoundPaddingBottom());
  }

  /**
   * Populate requested character bounds in a {@link CursorAnchorInfo.Builder}
   *
   * @param builder The builder to populate
   * @param startIndex The starting character index to populate
   * @param endIndex The ending character index to populate
   * @param viewportToContentHorizontalOffset The horizontal offset from the viewport to the
   * content
   * @param viewportToContentVerticalOffset The vertical offset from the viewport to the content
   * @hide
   */
  public void populateCharacterBounds(CursorAnchorInfo.Builder builder,
                                      int startIndex, int endIndex, float viewportToContentHorizontalOffset,
                                      float viewportToContentVerticalOffset) {
    if (isOffsetMappingAvailable()) {
      // The text is transformed, and has different length, we don't support
      // character bounds in this case yet.
      return;
    }
    final Rect rect = new Rect();
    getContentVisibleRect(rect);
    final RectF visibleRect = new RectF(rect);

    final float[] characterBounds = getCharacterBounds(startIndex, endIndex,
                                                       viewportToContentHorizontalOffset, viewportToContentVerticalOffset);
    final int limit = endIndex - startIndex;
    for (int offset = 0; offset < limit; ++offset) {
      final float left = characterBounds[offset * 4];
      final float top = characterBounds[offset * 4 + 1];
      final float right = characterBounds[offset * 4 + 2];
      final float bottom = characterBounds[offset * 4 + 3];

      final boolean hasVisibleRegion = visibleRect.intersects(left, top, right, bottom);
      final boolean hasInVisibleRegion = !visibleRect.contains(left, top, right, bottom);
      int characterBoundsFlags = 0;
      if (hasVisibleRegion) {
        characterBoundsFlags |= FLAG_HAS_VISIBLE_REGION;
      }
      if (hasInVisibleRegion) {
        characterBoundsFlags |= CursorAnchorInfo.FLAG_HAS_INVISIBLE_REGION;
      }

      if (mLayout.isRtlCharAt(offset)) {
        characterBoundsFlags |= CursorAnchorInfo.FLAG_IS_RTL;
      }
      builder.addCharacterBounds(offset + startIndex, left, top, right, bottom,
                                 characterBoundsFlags);
    }
  }

  /**
   * Return the bounds of the characters in the given range, in TextView's coordinates.
   *
   * @param start the start index of the interested text range, inclusive.
   * @param end the end index of the interested text range, exclusive.
   * @param layoutLeft the left of the given {@code layout} in the editor view's coordinates.
   * @param layoutTop  the top of the given {@code layout} in the editor view's coordinates.
   * @return the character bounds stored in a flattened array, in the editor view's coordinates.
   */
  private float[] getCharacterBounds(int start, int end, float layoutLeft, float layoutTop) {
    final float[] characterBounds = new float[4 * (end - start)];
    mLayout.fillCharacterBounds(start, end, characterBounds, 0);
    for (int offset = 0; offset < end - start; ++offset) {
      characterBounds[4 * offset] += layoutLeft;
      characterBounds[4 * offset + 1] += layoutTop;
      characterBounds[4 * offset + 2] += layoutLeft;
      characterBounds[4 * offset + 3] += layoutTop;
    }
    return characterBounds;
  }

  /**
   * Compute {@link CursorAnchorInfo} from this {@link TextView}.
   *
   * @param filter the {@link CursorAnchorInfo} update filter which specified the needed
   *               information from IME.
   * @param cursorAnchorInfoBuilder a cached {@link CursorAnchorInfo.Builder} object used to build
   *                                the result {@link CursorAnchorInfo}.
   * @param viewToScreenMatrix a cached {@link Matrix} object used to compute the view to screen
   *                           matrix.
   * @return the result {@link CursorAnchorInfo} to be passed to IME.
   * @hide
   */
  @VisibleForTesting
  @Nullable
  public CursorAnchorInfo getCursorAnchorInfo(@InputConnection.CursorUpdateFilter int filter,
                                              @NonNull CursorAnchorInfo.Builder cursorAnchorInfoBuilder,
                                              @NonNull Matrix viewToScreenMatrix) {
    Layout layout = getLayout();
    if (layout == null) {
      return null;
    }
    boolean includeEditorBounds =
      (filter & InputConnection.CURSOR_UPDATE_FILTER_EDITOR_BOUNDS) != 0;
    boolean includeCharacterBounds =
      (filter & InputConnection.CURSOR_UPDATE_FILTER_CHARACTER_BOUNDS) != 0;
    boolean includeInsertionMarker =
      (filter & InputConnection.CURSOR_UPDATE_FILTER_INSERTION_MARKER) != 0;
    boolean includeVisibleLineBounds =
      (filter & InputConnection.CURSOR_UPDATE_FILTER_VISIBLE_LINE_BOUNDS) != 0;
    boolean includeTextAppearance =
      (filter & InputConnection.CURSOR_UPDATE_FILTER_TEXT_APPEARANCE) != 0;
    boolean includeAll =
      (!includeEditorBounds && !includeCharacterBounds && !includeInsertionMarker
       && !includeVisibleLineBounds && !includeTextAppearance);

    includeEditorBounds |= includeAll;
    includeCharacterBounds |= includeAll;
    includeInsertionMarker |= includeAll;
    includeVisibleLineBounds |= includeAll;
    includeTextAppearance |= includeAll;

    final CursorAnchorInfo.Builder builder = cursorAnchorInfoBuilder;
    builder.reset();

    final int selectionStart = getSelectionStart();
    builder.setSelectionRange(selectionStart, getSelectionEnd());

    // Construct transformation matrix from view local coordinates to screen coordinates.
    viewToScreenMatrix.reset();
    transformMatrixToGlobal(viewToScreenMatrix);
    builder.setMatrix(viewToScreenMatrix);

    if (includeEditorBounds) {
      if (mTempRect == null) {
        mTempRect = new Rect();
      }
      final Rect bounds = mTempRect;
      final RectF editorBounds;
      final RectF handwritingBounds;
      if (getViewVisibleRect(bounds)) {
        editorBounds = new RectF(bounds);
        handwritingBounds = new RectF(editorBounds);
        handwritingBounds.top -= getHandwritingBoundsOffsetTop();
        handwritingBounds.left -= getHandwritingBoundsOffsetLeft();
        handwritingBounds.bottom += getHandwritingBoundsOffsetBottom();
        handwritingBounds.right += getHandwritingBoundsOffsetRight();
      } else {
        // The editor is not visible at all, return empty rectangles. We still need to
        // return an EditorBoundsInfo because IME has subscribed the EditorBoundsInfo.
        editorBounds = new RectF();
        handwritingBounds = new RectF();
      }
      EditorBoundsInfo.Builder boundsBuilder = new EditorBoundsInfo.Builder();
      EditorBoundsInfo editorBoundsInfo = boundsBuilder.setEditorBounds(editorBounds)
        .setHandwritingBounds(handwritingBounds).build();
      builder.setEditorBoundsInfo(editorBoundsInfo);
    }

    if (includeCharacterBounds || includeInsertionMarker || includeVisibleLineBounds) {
      final float viewportToContentHorizontalOffset =
        viewportToContentHorizontalOffset();
      final float viewportToContentVerticalOffset =
        viewportToContentVerticalOffset();
      final boolean isTextTransformed = (getTransformationMethod() != null
                                         && getTransformed() instanceof OffsetMapping);
      if (includeCharacterBounds && !isTextTransformed) {
        final CharSequence text = getText();
        if (text instanceof Spannable) {
          final Spannable sp = (Spannable) text;
          int composingTextStart = EditableInputConnection.getComposingSpanStart(sp);
          int composingTextEnd = EditableInputConnection.getComposingSpanEnd(sp);
          if (composingTextEnd < composingTextStart) {
            final int temp = composingTextEnd;
            composingTextEnd = composingTextStart;
            composingTextStart = temp;
          }
          final boolean hasComposingText =
            (0 <= composingTextStart) && (composingTextStart
                                          < composingTextEnd);
          if (hasComposingText) {
            final CharSequence composingText = text.subSequence(composingTextStart,
                                                                composingTextEnd);
            builder.setComposingText(composingTextStart, composingText);
            populateCharacterBounds(builder, composingTextStart,
                                    composingTextEnd, viewportToContentHorizontalOffset,
                                    viewportToContentVerticalOffset);
          }
        }
      }

      if (includeInsertionMarker) {
        // Treat selectionStart as the insertion point.
        if (0 <= selectionStart) {
          final int offsetTransformed = originalToTransformed(
            selectionStart, OffsetMapping.MAP_STRATEGY_CURSOR);
          final int line = layout.getLineForOffset(offsetTransformed);
          final float insertionMarkerX =
            layout.getPrimaryHorizontal(
              offsetTransformed, layout.shouldClampCursor(line))
            + viewportToContentHorizontalOffset;
          final float insertionMarkerTop = layout.getLineTop(line)
                                           + viewportToContentVerticalOffset;
          final float insertionMarkerBaseline = layout.getLineBaseline(line)
                                                + viewportToContentVerticalOffset;
          final float insertionMarkerBottom =
            layout.getLineBottom(line, /* includeLineSpacing= */ false)
            + viewportToContentVerticalOffset;
          final boolean isTopVisible =
            isPositionVisible(insertionMarkerX, insertionMarkerTop);
          final boolean isBottomVisible =
            isPositionVisible(insertionMarkerX, insertionMarkerBottom);
          int insertionMarkerFlags = 0;
          if (isTopVisible || isBottomVisible) {
            insertionMarkerFlags |= CursorAnchorInfo.FLAG_HAS_VISIBLE_REGION;
          }
          if (!isTopVisible || !isBottomVisible) {
            insertionMarkerFlags |= CursorAnchorInfo.FLAG_HAS_INVISIBLE_REGION;
          }
          if (layout.isRtlCharAt(offsetTransformed)) {
            insertionMarkerFlags |= CursorAnchorInfo.FLAG_IS_RTL;
          }
          builder.setInsertionMarkerLocation(insertionMarkerX, insertionMarkerTop,
                                             insertionMarkerBaseline, insertionMarkerBottom,
                                             insertionMarkerFlags);
        }
      }

      if (includeVisibleLineBounds) {
        final Rect visibleRect = new Rect();
        if (getContentVisibleRect(visibleRect)) {
          // Subtract the viewportToContentVerticalOffset to convert the view
          // coordinates to layout coordinates.
          final float visibleTop =
            visibleRect.top - viewportToContentVerticalOffset;
          final float visibleBottom =
            visibleRect.bottom - viewportToContentVerticalOffset;
          final int firstLine =
            layout.getLineForVertical((int) Math.floor(visibleTop));
          final int lastLine =
            layout.getLineForVertical((int) Math.ceil(visibleBottom));

          for (int line = firstLine; line <= lastLine; ++line) {
            final float left = layout.getLineLeft(line)
                               + viewportToContentHorizontalOffset;
            final float top = layout.getLineTop(line)
                              + viewportToContentVerticalOffset;
            final float right = layout.getLineRight(line)
                                + viewportToContentHorizontalOffset;
            final float bottom = layout.getLineBottom(line, false)
                                 + viewportToContentVerticalOffset;
            builder.addVisibleLineBounds(left, top, right, bottom);
          }
        }
      }
    }

    if (includeTextAppearance) {
      builder.setTextAppearanceInfo(TextAppearanceInfo.createFromTextView(this));
    }
    return builder.build();
  }

  /**
   * Creates the {@link TextBoundsInfo} for the text lines that intersects with the {@code rectF}.
   * @hide
   */
  public TextBoundsInfo getTextBoundsInfo(@NonNull RectF bounds) {
    final Layout layout = getLayout();
    if (layout == null) {
      // No valid text layout, return null.
      return null;
    }
    final CharSequence text = layout.getText();
    if (text == null || isOffsetMappingAvailable()) {
      // The text is Null or the text has been transformed. Can't provide TextBoundsInfo.
      return null;
    }

    final Matrix localToGlobalMatrix = new Matrix();
    transformMatrixToGlobal(localToGlobalMatrix);
    final Matrix globalToLocalMatrix = new Matrix();
    if (!localToGlobalMatrix.invert(globalToLocalMatrix)) {
      // Can't map global rectF to local coordinates, this is almost impossible in practice.
      return null;
    }

    final float layoutLeft = viewportToContentHorizontalOffset();
    final float layoutTop = viewportToContentVerticalOffset();

    final RectF localBounds = new RectF(bounds);
    globalToLocalMatrix.mapRect(localBounds);
    localBounds.offset(-layoutLeft, -layoutTop);

    // Text length is 0. There is no character bounds, return empty TextBoundsInfo.
    // rectF doesn't intersect with the layout, return empty TextBoundsInfo.
    if (!localBounds.intersects(0f, 0f, layout.getWidth(), layout.getHeight())
        || text.length() == 0) {
      final TextBoundsInfo.Builder builder = new TextBoundsInfo.Builder(0, 0);
      final SegmentFinder emptySegmentFinder =
        new SegmentFinder.PrescribedSegmentFinder(new int[0]);
      builder.setMatrix(localToGlobalMatrix)
        .setCharacterBounds(new float[0])
        .setCharacterBidiLevel(new int[0])
        .setCharacterFlags(new int[0])
        .setGraphemeSegmentFinder(emptySegmentFinder)
        .setLineSegmentFinder(emptySegmentFinder)
        .setWordSegmentFinder(emptySegmentFinder);
      return  builder.build();
    }

    final int startLine = layout.getLineForVertical((int) Math.floor(localBounds.top));
    final int endLine = layout.getLineForVertical((int) Math.floor(localBounds.bottom));
    final int start = layout.getLineStart(startLine);
    final int end = layout.getLineEnd(endLine);

    // Compute character bounds.
    final float[] characterBounds = getCharacterBounds(start, end, layoutLeft, layoutTop);

    // Compute character flags and BiDi levels.
    final int[] characterFlags = new int[end - start];
    final int[] characterBidiLevels = new int[end - start];
    for (int line = startLine; line <= endLine; ++line) {
      final int lineStart = layout.getLineStart(line);
      final int lineEnd = layout.getLineEnd(line);
      final Layout.Directions directions = layout.getLineDirections(line);
      for (int i = 0; i < directions.getRunCount(); ++i) {
        final int runStart = directions.getRunStart(i) + lineStart;
        final int runEnd = Math.min(runStart + directions.getRunLength(i), lineEnd);
        final int runLevel = directions.getRunLevel(i);
        Arrays.fill(characterBidiLevels, runStart - start, runEnd - start, runLevel);
      }

      final boolean lineIsRtl =
        layout.getParagraphDirection(line) == Layout.DIR_RIGHT_TO_LEFT;
      for (int index = lineStart; index < lineEnd; ++index) {
        int flags = 0;
        if (TextUtils.isWhitespace(text.charAt(index))) {
          flags |= TextBoundsInfo.FLAG_CHARACTER_WHITESPACE;
        }
        if (TextUtils.isPunctuation(Character.codePointAt(text, index))) {
          flags |= TextBoundsInfo.FLAG_CHARACTER_PUNCTUATION;
        }
        if (TextUtils.isNewline(Character.codePointAt(text, index))) {
          flags |= TextBoundsInfo.FLAG_CHARACTER_LINEFEED;
        }
        if (lineIsRtl) {
          flags |= TextBoundsInfo.FLAG_LINE_IS_RTL;
        }
        characterFlags[index - start] = flags;
      }
    }

    // Create grapheme SegmentFinder.
    final SegmentFinder graphemeSegmentFinder =
      new GraphemeClusterSegmentFinder(text, layout.getPaint());

    // Create word SegmentFinder.
    final WordIterator wordIterator = getWordIterator();
    wordIterator.setCharSequence(text, 0, text.length());
    final SegmentFinder wordSegmentFinder = new WordSegmentFinder(text, wordIterator);

    // Create line SegmentFinder.
    final int lineCount = endLine - startLine + 1;
    final int[] lineRanges = new int[2 * lineCount];
    for (int line = startLine; line <= endLine; ++line) {
      final int offset = line - startLine;
      lineRanges[2 * offset] = layout.getLineStart(line);
      lineRanges[2 * offset + 1] = layout.getLineEnd(line);
    }
    final SegmentFinder lineSegmentFinder =
      new SegmentFinder.PrescribedSegmentFinder(lineRanges);

    return new TextBoundsInfo.Builder(start, end)
      .setMatrix(localToGlobalMatrix)
      .setCharacterBounds(characterBounds)
      .setCharacterBidiLevel(characterBidiLevels)
      .setCharacterFlags(characterFlags)
      .setGraphemeSegmentFinder(graphemeSegmentFinder)
      .setLineSegmentFinder(lineSegmentFinder)
      .setWordSegmentFinder(wordSegmentFinder)
      .build();
  }

  /**
   * @hide
   */
  public boolean isPositionVisible(final float positionX, final float positionY) {
    synchronized (TEMP_POSITION) {
      final float[] position = TEMP_POSITION;
      position[0] = positionX;
      position[1] = positionY;
      View view = this;

      while (view != null) {
        if (view != this) {
          // Local scroll is already taken into account in positionX/Y
          position[0] -= view.getScrollX();
          position[1] -= view.getScrollY();
        }

        if (position[0] < 0 || position[1] < 0 || position[0] > view.getWidth()
            || position[1] > view.getHeight()) {
          return false;
        }

        if (!view.getMatrix().isIdentity()) {
          view.getMatrix().mapPoints(position);
        }

        position[0] += view.getLeft();
        position[1] += view.getTop();

        final ViewParent parent = view.getParent();
        if (parent instanceof View) {
          view = (View) parent;
        } else {
          // We've reached the ViewRoot, stop iterating
          view = null;
        }
      }
    }

    // We've been able to walk up the view hierarchy and the position was never clipped
    return true;
  }

  /**
   * Performs an accessibility action after it has been offered to the
   * delegate.
   *
   * @hide
   */
  @Override
  public boolean performAccessibilityActionInternal(int action, Bundle arguments) {
    if (mEditor != null) {
      if (mEditor.mProcessTextIntentActionsHandler.performAccessibilityAction(action)
          || mEditor.performSmartActionsAccessibilityAction(action)) {
        return true;
      }
    }
    switch (action) {
      case AccessibilityNodeInfo.ACTION_CLICK: {
        return performAccessibilityActionClick(arguments);
      }
      case AccessibilityNodeInfo.ACTION_COPY: {
        if (isFocused() && canCopy()) {
          if (onTextContextMenuItem(ID_COPY)) {
            return true;
          }
        }
      } return false;
      case AccessibilityNodeInfo.ACTION_PASTE: {
        if (isFocused() && canPaste()) {
          if (onTextContextMenuItem(ID_PASTE)) {
            return true;
          }
        }
      } return false;
      case AccessibilityNodeInfo.ACTION_CUT: {
        if (isFocused() && canCut()) {
          if (onTextContextMenuItem(ID_CUT)) {
            return true;
          }
        }
      } return false;
      case AccessibilityNodeInfo.ACTION_SET_SELECTION: {
        ensureIterableTextForAccessibilitySelectable();
        CharSequence text = getIterableTextForAccessibility();
        if (text == null) {
          return false;
        }
        final int start = (arguments != null) ? arguments.getInt(
          AccessibilityNodeInfo.ACTION_ARGUMENT_SELECTION_START_INT, -1) : -1;
        final int end = (arguments != null) ? arguments.getInt(
          AccessibilityNodeInfo.ACTION_ARGUMENT_SELECTION_END_INT, -1) : -1;
        if ((getSelectionStart() != start || getSelectionEnd() != end)) {
          // No arguments clears the selection.
          if (start == end && end == -1) {
            Selection.removeSelection((Spannable) text);
            return true;
          }
          if (start >= 0 && start <= end && end <= text.length()) {
            requestFocusOnNonEditableSelectableText();
            Selection.setSelection((Spannable) text, start, end);
            // Make sure selection mode is engaged.
            if (mEditor != null) {
              mEditor.startSelectionActionModeAsync(false);
            }
            return true;
          }
        }
      } return false;
      case AccessibilityNodeInfo.ACTION_NEXT_AT_MOVEMENT_GRANULARITY:
      case AccessibilityNodeInfo.ACTION_PREVIOUS_AT_MOVEMENT_GRANULARITY: {
        ensureIterableTextForAccessibilitySelectable();
        return super.performAccessibilityActionInternal(action, arguments);
      }
      case ACCESSIBILITY_ACTION_SHARE: {
        if (isFocused() && canShare()) {
          if (onTextContextMenuItem(ID_SHARE)) {
            return true;
          }
        }
      } return false;
      case AccessibilityNodeInfo.ACTION_SET_TEXT: {
        if (!isEnabled() || (mBufferType != BufferType.EDITABLE)) {
          return false;
        }
        CharSequence text = (arguments != null) ? arguments.getCharSequence(
          AccessibilityNodeInfo.ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE) : null;
        setText(text);
        if (mText != null) {
          int updatedTextLength = mText.length();
          if (updatedTextLength > 0) {
            Selection.setSelection(mSpannable, updatedTextLength);
          }
        }
      } return true;
      case R.id.accessibilityActionImeEnter: {
        if (isFocused() && isTextEditable()) {
          onEditorAction(getImeActionId());
        }
      } return true;
      case AccessibilityNodeInfo.ACTION_LONG_CLICK: {
        if (isLongClickable()) {
          boolean handled;
          if (isEnabled() && (mBufferType == BufferType.EDITABLE)) {
            mEditor.mIsBeingLongClickedByAccessibility = true;
            try {
              handled = performLongClick();
            } finally {
              mEditor.mIsBeingLongClickedByAccessibility = false;
            }
          } else {
            handled = performLongClick();
          }
          return handled;
        }
      }
      return false;
      default: {
        // New ids have static blocks to assign values, so they can't be used in a case
        // block.
        if (action == R.id.accessibilityActionShowTextSuggestions) {
          return isFocused() && canReplace() && onTextContextMenuItem(ID_REPLACE);
        }
        return super.performAccessibilityActionInternal(action, arguments);
      }
    }
  }

  private boolean performAccessibilityActionClick(Bundle arguments) {
    boolean handled = false;

    if (!isEnabled()) {
      return false;
    }

    if (isClickable() || isLongClickable()) {
      // Simulate View.onTouchEvent for an ACTION_UP event
      if (isFocusable() && !isFocused()) {
        requestFocus();
      }

      performClick();
      handled = true;
    }

    // Show the IME, except when selecting in read-only text.
    if ((mMovement != null || onCheckIsTextEditor()) && hasSpannableText() && mLayout != null
        && (isTextEditable() || isTextSelectable()) && isFocused()) {
      final InputMethodManager imm = getInputMethodManager();
      viewClicked(imm);
      if (!isTextSelectable() && mEditor.mShowSoftInputOnFocus && imm != null) {
        handled |= imm.showSoftInput(this, 0);
      }
    }

    return handled;
  }

  private void requestFocusOnNonEditableSelectableText() {
    if (!isTextEditable() && isTextSelectable()) {
      if (!isEnabled()) {
        return;
      }

      if (isFocusable() && !isFocused()) {
        requestFocus();
      }
    }
  }

  private boolean hasSpannableText() {
    return mText != null && mText instanceof Spannable;
  }

  /** @hide */
  @Override
  public void sendAccessibilityEventInternal(int eventType) {
    if (eventType == AccessibilityEvent.TYPE_VIEW_ACCESSIBILITY_FOCUSED && mEditor != null) {
      mEditor.mProcessTextIntentActionsHandler.initializeAccessibilityActions();
    }

    super.sendAccessibilityEventInternal(eventType);
  }

  @Override
  public void sendAccessibilityEventUnchecked(AccessibilityEvent event) {
    // Do not send scroll events since first they are not interesting for
    // accessibility and second such events a generated too frequently.
    // For details see the implementation of bringTextIntoView().
    if (event.getEventType() == AccessibilityEvent.TYPE_VIEW_SCROLLED) {
      return;
    }
    super.sendAccessibilityEventUnchecked(event);
  }

  /**
   * Returns the text that should be exposed to accessibility services.
   * <p>
   * This approximates what is displayed visually.
   *
   * @return the text that should be exposed to accessibility services, may
   *         be {@code null} if no text is set
   */
  @Nullable
  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
  private CharSequence getTextForAccessibility() {
    // If the text is empty, we must be showing the hint text.
    if (TextUtils.isEmpty(mText)) {
      return mHint;
    }

    // Otherwise, return whatever text is being displayed.
    return TextUtils.trimToParcelableSize(mTransformed);
  }

  boolean isVisibleToAccessibility() {
    return AccessibilityManager.getInstance(mContext).isEnabled()
           && (isFocused() || (isSelected() && isShown()));
  }

  void sendAccessibilityEventTypeViewTextChanged(CharSequence beforeText,
                                                 int fromIndex, int removedCount, int addedCount) {
    AccessibilityEvent event =
      AccessibilityEvent.obtain(AccessibilityEvent.TYPE_VIEW_TEXT_CHANGED);
    event.setFromIndex(fromIndex);
    event.setRemovedCount(removedCount);
    event.setAddedCount(addedCount);
    event.setBeforeText(beforeText);
    sendAccessibilityEventUnchecked(event);
  }

  void sendAccessibilityEventTypeViewTextChanged(CharSequence beforeText,
                                                 int fromIndex, int toIndex) {
    AccessibilityEvent event =
      AccessibilityEvent.obtain(AccessibilityEvent.TYPE_VIEW_TEXT_CHANGED);
    event.setFromIndex(fromIndex);
    event.setToIndex(toIndex);
    event.setBeforeText(beforeText);
    sendAccessibilityEventUnchecked(event);
  }

  private InputMethodManager getInputMethodManager() {
    return getContext().getSystemService(InputMethodManager.class);
  }

  /**
   * Returns whether this text view is a current input method target.  The
   * default implementation just checks with {@link InputMethodManager}.
   * @return True if the TextView is a current input method target; false otherwise.
   */
  public boolean isInputMethodTarget() {
    InputMethodManager imm = getInputMethodManager();
    return imm != null && imm.isActive(this);
  }

  static final int ID_SELECT_ALL = android.R.id.selectAll;
  static final int ID_UNDO = android.R.id.undo;
  static final int ID_REDO = android.R.id.redo;
  static final int ID_CUT = android.R.id.cut;
  static final int ID_COPY = android.R.id.copy;
  static final int ID_PASTE = android.R.id.paste;
  static final int ID_SHARE = android.R.id.shareText;
  static final int ID_PASTE_AS_PLAIN_TEXT = android.R.id.pasteAsPlainText;
  static final int ID_REPLACE = android.R.id.replaceText;
  static final int ID_ASSIST = android.R.id.textAssist;
  static final int ID_AUTOFILL = android.R.id.autofill;

  /**
   * Called when a context menu option for the text view is selected.  Currently
   * this will be one of {@link android.R.id#selectAll}, {@link android.R.id#cut},
   * {@link android.R.id#copy}, {@link android.R.id#paste},
   * {@link android.R.id#pasteAsPlainText} (starting at API level 23) or
   * {@link android.R.id#shareText}.
   *
   * @return true if the context menu item action was performed.
   */
  public boolean onTextContextMenuItem(int id) {
    int min = 0;
    int max = mText.length();

    if (isFocused()) {
      final int selStart = getSelectionStart();
      final int selEnd = getSelectionEnd();

      min = Math.max(0, Math.min(selStart, selEnd));
      max = Math.max(0, Math.max(selStart, selEnd));
    }

    switch (id) {
      case ID_SELECT_ALL:
        final boolean hadSelection = hasSelection();
        selectAllText();
        if (mEditor != null && hadSelection) {
          mEditor.invalidateActionModeAsync();
        }
        return true;

      case ID_UNDO:
        if (mEditor != null) {
          mEditor.undo();
        }
        return true;  // Returns true even if nothing was undone.

      case ID_REDO:
        if (mEditor != null) {
          mEditor.redo();
        }
        return true;  // Returns true even if nothing was undone.

      case ID_PASTE:
        paste(true /* withFormatting */);
        return true;

      case ID_PASTE_AS_PLAIN_TEXT:
        paste(false /* withFormatting */);
        return true;

      case ID_CUT:
        final ClipData cutData = ClipData.newPlainText(null, getTransformedText(min, max));
        if (setPrimaryClip(cutData)) {
          deleteText_internal(min, max);
        } else {
          Toast.makeText(getContext(),
                         com.android.internal.R.string.failed_to_copy_to_clipboard,
                         Toast.LENGTH_SHORT).show();
        }
        return true;

      case ID_COPY:
        // For link action mode in a non-selectable/non-focusable TextView,
        // make sure that we set the appropriate min/max.
        final int selStart = getSelectionStart();
        final int selEnd = getSelectionEnd();
        min = Math.max(0, Math.min(selStart, selEnd));
        max = Math.max(0, Math.max(selStart, selEnd));
        final ClipData copyData = ClipData.newPlainText(null, getTransformedText(min, max));
        if (setPrimaryClip(copyData)) {
          stopTextActionMode();
        } else {
          Toast.makeText(getContext(),
                         com.android.internal.R.string.failed_to_copy_to_clipboard,
                         Toast.LENGTH_SHORT).show();
        }
        return true;

      case ID_REPLACE:
        if (mEditor != null) {
          mEditor.replace();
        }
        return true;

      case ID_SHARE:
        shareSelectedText();
        return true;

      case ID_AUTOFILL:
        requestAutofill();
        stopTextActionMode();
        return true;
    }
    return false;
  }

  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
  CharSequence getTransformedText(int start, int end) {
    return removeSuggestionSpans(mTransformed.subSequence(start, end));
  }

  @Override
  public boolean performLongClick() {
    if (DEBUG_CURSOR) {
      logCursor("performLongClick", null);
    }

    boolean handled = false;
    boolean performedHapticFeedback = false;

    if (mEditor != null) {
      mEditor.mIsBeingLongClicked = true;
    }

    if (super.performLongClick()) {
      handled = true;
      performedHapticFeedback = true;
    }

    if (mEditor != null) {
      handled |= mEditor.performLongClick(handled);
      mEditor.mIsBeingLongClicked = false;
    }

    if (handled) {
      if (!performedHapticFeedback) {
        performHapticFeedback(HapticFeedbackConstants.LONG_PRESS);
      }
      if (mEditor != null) mEditor.mDiscardNextActionUp = true;
    } else {
      MetricsLogger.action(
        mContext,
        MetricsEvent.TEXT_LONGPRESS,
        TextViewMetrics.SUBTYPE_LONG_PRESS_OTHER);
    }

    return handled;
  }

  @Override
  protected void onScrollChanged(int horiz, int vert, int oldHoriz, int oldVert) {
    super.onScrollChanged(horiz, vert, oldHoriz, oldVert);
    if (mEditor != null) {
      mEditor.onScrollChanged();
    }
  }

  /**
   * Return whether or not suggestions are enabled on this TextView. The suggestions are generated
   * by the IME or by the spell checker as the user types. This is done by adding
   * {@link SuggestionSpan}s to the text.
   *
   * When suggestions are enabled (default), this list of suggestions will be displayed when the
   * user asks for them on these parts of the text. This value depends on the inputType of this
   * TextView.
   *
   * The class of the input type must be {@link InputType#TYPE_CLASS_TEXT}.
   *
   * In addition, the type variation must be one of
   * {@link InputType#TYPE_TEXT_VARIATION_NORMAL},
   * {@link InputType#TYPE_TEXT_VARIATION_EMAIL_SUBJECT},
   * {@link InputType#TYPE_TEXT_VARIATION_LONG_MESSAGE},
   * {@link InputType#TYPE_TEXT_VARIATION_SHORT_MESSAGE} or
   * {@link InputType#TYPE_TEXT_VARIATION_WEB_EDIT_TEXT}.
   *
   * And finally, the {@link InputType#TYPE_TEXT_FLAG_NO_SUGGESTIONS} flag must <i>not</i> be set.
   *
   * @return true if the suggestions popup window is enabled, based on the inputType.
   */
  public boolean isSuggestionsEnabled() {
    if (mEditor == null) return false;
    if ((mEditor.mInputType & InputType.TYPE_MASK_CLASS) != InputType.TYPE_CLASS_TEXT) {
      return false;
    }
    if ((mEditor.mInputType & InputType.TYPE_TEXT_FLAG_NO_SUGGESTIONS) > 0) return false;

    final int variation = mEditor.mInputType & EditorInfo.TYPE_MASK_VARIATION;
    return (variation == EditorInfo.TYPE_TEXT_VARIATION_NORMAL
            || variation == EditorInfo.TYPE_TEXT_VARIATION_EMAIL_SUBJECT
            || variation == EditorInfo.TYPE_TEXT_VARIATION_LONG_MESSAGE
            || variation == EditorInfo.TYPE_TEXT_VARIATION_SHORT_MESSAGE
            || variation == EditorInfo.TYPE_TEXT_VARIATION_WEB_EDIT_TEXT);
  }

  /**
   * If provided, this ActionMode.Callback will be used to create the ActionMode when text
   * selection is initiated in this View.
   *
   * <p>The standard implementation populates the menu with a subset of Select All, Cut, Copy,
   * Paste, Replace and Share actions, depending on what this View supports.
   *
   * <p>A custom implementation can add new entries in the default menu in its
   * {@link android.view.ActionMode.Callback#onPrepareActionMode(ActionMode, android.view.Menu)}
   * method. The default actions can also be removed from the menu using
   * {@link android.view.Menu#removeItem(int)} and passing {@link android.R.id#selectAll},
   * {@link android.R.id#cut}, {@link android.R.id#copy}, {@link android.R.id#paste},
   * {@link android.R.id#pasteAsPlainText} (starting at API level 23),
   * {@link android.R.id#replaceText} or {@link android.R.id#shareText} ids as parameters.
   *
   * <p>Returning false from
   * {@link android.view.ActionMode.Callback#onCreateActionMode(ActionMode, android.view.Menu)}
   * will prevent the action mode from being started.
   *
   * <p>Action click events should be handled by the custom implementation of
   * {@link android.view.ActionMode.Callback#onActionItemClicked(ActionMode,
   * android.view.MenuItem)}.
   *
   * <p>Note that text selection mode is not started when a TextView receives focus and the
   * {@link android.R.attr#selectAllOnFocus} flag has been set. The content is highlighted in
   * that case, to allow for quick replacement.
   */
  public void setCustomSelectionActionModeCallback(ActionMode.Callback actionModeCallback) {
    createEditorIfNeeded();
    mEditor.mCustomSelectionActionModeCallback = actionModeCallback;
  }

  /**
   * Retrieves the value set in {@link #setCustomSelectionActionModeCallback}. Default is null.
   *
   * @return The current custom selection callback.
   */
  public ActionMode.Callback getCustomSelectionActionModeCallback() {
    return mEditor == null ? null : mEditor.mCustomSelectionActionModeCallback;
  }

  /**
   * If provided, this ActionMode.Callback will be used to create the ActionMode when text
   * insertion is initiated in this View.
   * The standard implementation populates the menu with a subset of Select All,
   * Paste and Replace actions, depending on what this View supports.
   *
   * <p>A custom implementation can add new entries in the default menu in its
   * {@link android.view.ActionMode.Callback#onPrepareActionMode(android.view.ActionMode,
   * android.view.Menu)} method. The default actions can also be removed from the menu using
   * {@link android.view.Menu#removeItem(int)} and passing {@link android.R.id#selectAll},
   * {@link android.R.id#paste}, {@link android.R.id#pasteAsPlainText} (starting at API
   * level 23) or {@link android.R.id#replaceText} ids as parameters.</p>
   *
   * <p>Returning false from
   * {@link android.view.ActionMode.Callback#onCreateActionMode(android.view.ActionMode,
   * android.view.Menu)} will prevent the action mode from being started.</p>
   *
   * <p>Action click events should be handled by the custom implementation of
   * {@link android.view.ActionMode.Callback#onActionItemClicked(android.view.ActionMode,
   * android.view.MenuItem)}.</p>
   *
   * <p>Note that text insertion mode is not started when a TextView receives focus and the
   * {@link android.R.attr#selectAllOnFocus} flag has been set.</p>
   */
  public void setCustomInsertionActionModeCallback(ActionMode.Callback actionModeCallback) {
    createEditorIfNeeded();
    mEditor.mCustomInsertionActionModeCallback = actionModeCallback;
  }

  /**
   * Retrieves the value set in {@link #setCustomInsertionActionModeCallback}. Default is null.
   *
   * @return The current custom insertion callback.
   */
  public ActionMode.Callback getCustomInsertionActionModeCallback() {
    return mEditor == null ? null : mEditor.mCustomInsertionActionModeCallback;
  }

  /**
   * Sets the {@link TextClassifier} for this TextView.
   */
  public void setTextClassifier(@Nullable TextClassifier textClassifier) {
    mTextClassifier = textClassifier;
  }

  /**
   * Returns the {@link TextClassifier} used by this TextView.
   * If no TextClassifier has been set, this TextView uses the default set by the
   * {@link TextClassificationManager}.
   */
  @NonNull
  public TextClassifier getTextClassifier() {
    if (mTextClassifier == null) {
      final TextClassificationManager tcm = getTextClassificationManagerForUser();
      if (tcm != null) {
        return tcm.getTextClassifier();
      }
      return TextClassifier.NO_OP;
    }
    return mTextClassifier;
  }

  /**
   * Returns a session-aware text classifier.
   * This method creates one if none already exists or the current one is destroyed.
   */
  @NonNull
  TextClassifier getTextClassificationSession() {
    if (mTextClassificationSession == null || mTextClassificationSession.isDestroyed()) {
      final TextClassificationManager tcm = getTextClassificationManagerForUser();
      if (tcm != null) {
        final String widgetType;
        if (isTextEditable()) {
          widgetType = TextClassifier.WIDGET_TYPE_EDITTEXT;
        } else if (isTextSelectable()) {
          widgetType = TextClassifier.WIDGET_TYPE_TEXTVIEW;
        } else {
          widgetType = TextClassifier.WIDGET_TYPE_UNSELECTABLE_TEXTVIEW;
        }
        mTextClassificationContext = new TextClassificationContext.Builder(
          mContext.getPackageName(), widgetType)
          .build();
        if (mTextClassifier != null) {
          mTextClassificationSession = tcm.createTextClassificationSession(
            mTextClassificationContext, mTextClassifier);
        } else {
          mTextClassificationSession = tcm.createTextClassificationSession(
            mTextClassificationContext);
        }
      } else {
        mTextClassificationSession = TextClassifier.NO_OP;
      }
    }
    return mTextClassificationSession;
  }

  /**
   * Returns the {@link TextClassificationContext} for the current TextClassifier session.
   * @see #getTextClassificationSession()
   */
  @Nullable
  TextClassificationContext getTextClassificationContext() {
    return mTextClassificationContext;
  }

  /**
   * Returns true if this TextView uses a no-op TextClassifier.
   */
  boolean usesNoOpTextClassifier() {
    return getTextClassifier() == TextClassifier.NO_OP;
  }

  /**
   * Starts an ActionMode for the specified TextLinkSpan.
   *
   * @return Whether or not we're attempting to start the action mode.
   * @hide
   */
  public boolean requestActionMode(@NonNull TextLinks.TextLinkSpan clickedSpan) {
    Preconditions.checkNotNull(clickedSpan);

    if (!(mText instanceof Spanned)) {
      return false;
    }

    final int start = ((Spanned) mText).getSpanStart(clickedSpan);
    final int end = ((Spanned) mText).getSpanEnd(clickedSpan);

    if (start < 0 || end > mText.length() || start >= end) {
      return false;
    }

    createEditorIfNeeded();
    mEditor.startLinkActionModeAsync(start, end);
    return true;
  }

  /**
   * Handles a click on the specified TextLinkSpan.
   *
   * @return Whether or not the click is being handled.
   * @hide
   */
  public boolean handleClick(@NonNull TextLinks.TextLinkSpan clickedSpan) {
    Preconditions.checkNotNull(clickedSpan);
    if (mText instanceof Spanned) {
      final Spanned spanned = (Spanned) mText;
      final int start = spanned.getSpanStart(clickedSpan);
      final int end = spanned.getSpanEnd(clickedSpan);
      if (start >= 0 && end <= mText.length() && start < end) {
        final TextClassification.Request request = new TextClassification.Request.Builder(
          mText, start, end)
          .setDefaultLocales(getTextLocales())
          .build();
        final Supplier<TextClassification> supplier = () ->
          getTextClassificationSession().classifyText(request);
        final Consumer<TextClassification> consumer = classification -> {
          if (classification != null) {
            if (!classification.getActions().isEmpty()) {
              try {
                classification.getActions().get(0).getActionIntent().send();
              } catch (PendingIntent.CanceledException e) {
                Log.e(LOG_TAG, "Error sending PendingIntent", e);
              }
            } else {
              Log.d(LOG_TAG, "No link action to perform");
            }
          } else {
            // classification == null
            Log.d(LOG_TAG, "Timeout while classifying text");
          }
        };
        CompletableFuture.supplyAsync(supplier)
          .completeOnTimeout(null, 1, TimeUnit.SECONDS)
          .thenAccept(consumer);
        return true;
      }
    }
    return false;
  }

  /**
   * @hide
   */
  @UnsupportedAppUsage
  protected void stopTextActionMode() {
    if (mEditor != null) {
      mEditor.stopTextActionMode();
    }
  }

  /** @hide */
  public void hideFloatingToolbar(int durationMs) {
    if (mEditor != null) {
      mEditor.hideFloatingToolbar(durationMs);
    }
  }

  boolean canUndo() {
    return mEditor != null && mEditor.canUndo();
  }

  boolean canRedo() {
    return mEditor != null && mEditor.canRedo();
  }

  boolean canCut() {
    if (hasPasswordTransformationMethod()) {
      return false;
    }

    if (mText.length() > 0 && hasSelection() && mText instanceof Editable && mEditor != null
        && mEditor.mKeyListener != null) {
      return true;
    }

    return false;
  }

  boolean canCopy() {
    if (hasPasswordTransformationMethod()) {
      return false;
    }

    if (mText.length() > 0 && hasSelection() && mEditor != null) {
      return true;
    }

    return false;
  }

  boolean canReplace() {
    if (hasPasswordTransformationMethod()) {
      return false;
    }

    return (mText.length() > 0) && (mText instanceof Editable) && (mEditor != null)
           && isSuggestionsEnabled() && mEditor.shouldOfferToShowSuggestions();
  }

  boolean canShare() {
    if (!getContext().canStartActivityForResult() || !isDeviceProvisioned()
        || !getContext().getResources().getBoolean(
      com.android.internal.R.bool.config_textShareSupported)) {
      return false;
    }
    return canCopy();
  }

  boolean isDeviceProvisioned() {
    if (mDeviceProvisionedState == DEVICE_PROVISIONED_UNKNOWN) {
      mDeviceProvisionedState = Settings.Global.getInt(
        mContext.getContentResolver(), Settings.Global.DEVICE_PROVISIONED, 0) != 0
                                ? DEVICE_PROVISIONED_YES
                                : DEVICE_PROVISIONED_NO;
    }
    return mDeviceProvisionedState == DEVICE_PROVISIONED_YES;
  }

  @UnsupportedAppUsage
  boolean canPaste() {
    return (mText instanceof Editable
            && mEditor != null && mEditor.mKeyListener != null
            && getSelectionStart() >= 0
            && getSelectionEnd() >= 0
            && getClipboardManagerForUser().hasPrimaryClip());
  }

  boolean canPasteAsPlainText() {
    if (!canPaste()) {
      return false;
    }

    final ClipDescription description =
      getClipboardManagerForUser().getPrimaryClipDescription();
    if (description == null) {
      return false;
    }
    final boolean isPlainType = description.hasMimeType(ClipDescription.MIMETYPE_TEXT_PLAIN);
    return (isPlainType && description.isStyledText())
           || description.hasMimeType(ClipDescription.MIMETYPE_TEXT_HTML);
  }

  boolean canProcessText() {
    if (getId() == View.NO_ID) {
      return false;
    }
    return canShare();
  }

  boolean canSelectAllText() {
    return canSelectText() && !hasPasswordTransformationMethod()
           && !(getSelectionStart() == 0 && getSelectionEnd() == mText.length());
  }

  boolean selectAllText() {
    if (mEditor != null) {
      // Hide the toolbar before changing the selection to avoid flickering.
      hideFloatingToolbar(FLOATING_TOOLBAR_SELECT_ALL_REFRESH_DELAY);
    }
    final int length = mText.length();
    Selection.setSelection(mSpannable, 0, length);
    return length > 0;
  }

  private void paste(boolean withFormatting) {
    ClipboardManager clipboard = getClipboardManagerForUser();
    ClipData clip = clipboard.getPrimaryClip();
    if (clip == null) {
      return;
    }
    final ContentInfo payload = new ContentInfo.Builder(clip, SOURCE_CLIPBOARD)
      .setFlags(withFormatting ? 0 : FLAG_CONVERT_TO_PLAIN_TEXT)
      .build();
    performReceiveContent(payload);
    sLastCutCopyOrTextChangedTime = 0;
  }

  private void shareSelectedText() {
    String selectedText = getSelectedText();
    if (selectedText != null && !selectedText.isEmpty()) {
      Intent sharingIntent = new Intent(android.content.Intent.ACTION_SEND);
      sharingIntent.setType("text/plain");
      sharingIntent.removeExtra(android.content.Intent.EXTRA_TEXT);
      selectedText = TextUtils.trimToParcelableSize(selectedText);
      sharingIntent.putExtra(android.content.Intent.EXTRA_TEXT, selectedText);
      getContext().startActivity(Intent.createChooser(sharingIntent, null));
      Selection.setSelection(mSpannable, getSelectionEnd());
    }
  }

  @CheckResult
  private boolean setPrimaryClip(ClipData clip) {
    ClipboardManager clipboard = getClipboardManagerForUser();
    try {
      clipboard.setPrimaryClip(clip);
    } catch (Throwable t) {
      return false;
    }
    sLastCutCopyOrTextChangedTime = SystemClock.uptimeMillis();
    return true;
  }

  /**
   * Get the character offset closest to the specified absolute position. A typical use case is to
   * pass the result of {@link MotionEvent#getX()} and {@link MotionEvent#getY()} to this method.
   *
   * @param x The horizontal absolute position of a point on screen
   * @param y The vertical absolute position of a point on screen
   * @return the character offset for the character whose position is closest to the specified
   *  position. Returns -1 if there is no layout.
   */
  public int getOffsetForPosition(float x, float y) {
    if (getLayout() == null) return -1;
    final int line = getLineAtCoordinate(y);
    final int offset = getOffsetAtCoordinate(line, x);
    return offset;
  }

  float convertToLocalHorizontalCoordinate(float x) {
    x -= getTotalPaddingLeft();
    // Clamp the position to inside of the view.
    x = Math.max(0.0f, x);
    x = Math.min(getWidth() - getTotalPaddingRight() - 1, x);
    x += getScrollX();
    return x;
  }

  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
  int getLineAtCoordinate(float y) {
    y -= getTotalPaddingTop();
    // Clamp the position to inside of the view.
    y = Math.max(0.0f, y);
    y = Math.min(getHeight() - getTotalPaddingBottom() - 1, y);
    y += getScrollY();
    return getLayout().getLineForVertical((int) y);
  }

  int getLineAtCoordinateUnclamped(float y) {
    y -= getTotalPaddingTop();
    y += getScrollY();
    return getLayout().getLineForVertical((int) y);
  }

  int getOffsetAtCoordinate(int line, float x) {
    x = convertToLocalHorizontalCoordinate(x);
    final int offset = getLayout().getOffsetForHorizontal(line, x);
    return transformedToOriginal(offset, OffsetMapping.MAP_STRATEGY_CURSOR);
  }

  /**
   * Convenient method to convert an offset on the transformed text to the original text.
   * @hide
   */
  public int transformedToOriginal(int offset, @OffsetMapping.MapStrategy int strategy) {
    if (getTransformationMethod() == null) {
      return offset;
    }
    if (mTransformed instanceof OffsetMapping) {
      final OffsetMapping transformedText = (OffsetMapping) mTransformed;
      return transformedText.transformedToOriginal(offset, strategy);
    }
    return offset;
  }

  /**
   * Convenient method to convert an offset on the original text to the transformed text.
   * @hide
   */
  public int originalToTransformed(int offset, @OffsetMapping.MapStrategy int strategy) {
    if (getTransformationMethod() == null) {
      return offset;
    }
    if (mTransformed instanceof OffsetMapping) {
      final OffsetMapping transformedText = (OffsetMapping) mTransformed;
      return transformedText.originalToTransformed(offset, strategy);
    }
    return offset;
  }
  /**
   * Handles drag events sent by the system following a call to
   * {@link android.view.View#startDragAndDrop(ClipData,DragShadowBuilder,Object,int)
   * startDragAndDrop()}.
   *
   * <p>If this text view is not editable, delegates to the default {@link View#onDragEvent}
   * implementation.
   *
   * <p>If this text view is editable, accepts all drag actions (returns true for an
   * {@link android.view.DragEvent#ACTION_DRAG_STARTED ACTION_DRAG_STARTED} event and all
   * subsequent drag events). While the drag is in progress, updates the cursor position
   * to follow the touch location. Once a drop event is received, handles content insertion
   * via {@link #performReceiveContent}.
   *
   * @param event The {@link android.view.DragEvent} sent by the system.
   * The {@link android.view.DragEvent#getAction()} method returns an action type constant
   * defined in DragEvent, indicating the type of drag event represented by this object.
   * @return Returns true if this text view is editable and delegates to super otherwise.
   * See {@link View#onDragEvent}.
   */
  @Override
  public boolean onDragEvent(DragEvent event) {
    if (mEditor == null || !mEditor.hasInsertionController()) {
      // If this TextView is not editable, defer to the default View implementation. This
      // will check for the presence of an OnReceiveContentListener and accept/reject
      // drag events depending on whether the listener is/isn't set.
      return super.onDragEvent(event);
    }
    switch (event.getAction()) {
      case DragEvent.ACTION_DRAG_STARTED:
        return true;

      case DragEvent.ACTION_DRAG_ENTERED:
        TextView.this.requestFocus();
        return true;

      case DragEvent.ACTION_DRAG_LOCATION:
        if (mText instanceof Spannable) {
          final int offset = getOffsetForPosition(event.getX(), event.getY());
          Selection.setSelection(mSpannable, offset);
        }
        return true;

      case DragEvent.ACTION_DROP:
        if (mEditor != null) mEditor.onDrop(event);
        return true;

      case DragEvent.ACTION_DRAG_ENDED:
      case DragEvent.ACTION_DRAG_EXITED:
      default:
        return true;
    }
  }

  boolean isInBatchEditMode() {
    if (mEditor == null) return false;
    final Editor.InputMethodState ims = mEditor.mInputMethodState;
    if (ims != null) {
      return ims.mBatchEditNesting > 0;
    }
    return mEditor.mInBatchEditControllers;
  }

  @Override
  public void onRtlPropertiesChanged(int layoutDirection) {
    super.onRtlPropertiesChanged(layoutDirection);

    final TextDirectionHeuristic newTextDir = getTextDirectionHeuristic();
    if (mTextDir != newTextDir) {
      mTextDir = newTextDir;
      if (mLayout != null) {
        checkForRelayout();
      }
    }
  }

  /**
   * Returns resolved {@link TextDirectionHeuristic} that will be used for text layout.
   * The {@link TextDirectionHeuristic} that is used by TextView is only available after
   * {@link #getTextDirection()} and {@link #getLayoutDirection()} is resolved. Therefore the
   * return value may not be the same as the one TextView uses if the View's layout direction is
   * not resolved or detached from parent root view.
   */
  public @NonNull TextDirectionHeuristic getTextDirectionHeuristic() {
    if (hasPasswordTransformationMethod()) {
      // passwords fields should be LTR
      return TextDirectionHeuristics.LTR;
    }

    if (mEditor != null
        && (mEditor.mInputType & EditorInfo.TYPE_MASK_CLASS)
           == EditorInfo.TYPE_CLASS_PHONE) {
      // Phone numbers must be in the direction of the locale's digits. Most locales have LTR
      // digits, but some locales, such as those written in the Adlam or N'Ko scripts, have
      // RTL digits.
      final DecimalFormatSymbols symbols = DecimalFormatSymbols.getInstance(getTextLocale());
      final String zero = symbols.getDigitStrings()[0];
      // In case the zero digit is multi-codepoint, just use the first codepoint to determine
      // direction.
      final int firstCodepoint = zero.codePointAt(0);
      final byte digitDirection = Character.getDirectionality(firstCodepoint);
      if (digitDirection == Character.DIRECTIONALITY_RIGHT_TO_LEFT
          || digitDirection == Character.DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC) {
        return TextDirectionHeuristics.RTL;
      } else {
        return TextDirectionHeuristics.LTR;
      }
    }

    // Always need to resolve layout direction first
    final boolean defaultIsRtl = (getLayoutDirection() == LAYOUT_DIRECTION_RTL);

    // Now, we can select the heuristic
    switch (getTextDirection()) {
      default:
      case TEXT_DIRECTION_FIRST_STRONG:
        return (defaultIsRtl ? TextDirectionHeuristics.FIRSTSTRONG_RTL :
                TextDirectionHeuristics.FIRSTSTRONG_LTR);
      case TEXT_DIRECTION_ANY_RTL:
        return TextDirectionHeuristics.ANYRTL_LTR;
      case TEXT_DIRECTION_LTR:
        return TextDirectionHeuristics.LTR;
      case TEXT_DIRECTION_RTL:
        return TextDirectionHeuristics.RTL;
      case TEXT_DIRECTION_LOCALE:
        return TextDirectionHeuristics.LOCALE;
      case TEXT_DIRECTION_FIRST_STRONG_LTR:
        return TextDirectionHeuristics.FIRSTSTRONG_LTR;
      case TEXT_DIRECTION_FIRST_STRONG_RTL:
        return TextDirectionHeuristics.FIRSTSTRONG_RTL;
    }
  }

  /**
   * @hide
   */
  @Override
  public void onResolveDrawables(int layoutDirection) {
    // No need to resolve twice
    if (mLastLayoutDirection == layoutDirection) {
      return;
    }
    mLastLayoutDirection = layoutDirection;

    // Resolve drawables
    if (mDrawables != null) {
      if (mDrawables.resolveWithLayoutDirection(layoutDirection)) {
        prepareDrawableForDisplay(mDrawables.mShowing[Drawables.LEFT]);
        prepareDrawableForDisplay(mDrawables.mShowing[Drawables.RIGHT]);
        applyCompoundDrawableTint();
      }
    }
  }

  /**
   * Prepares a drawable for display by propagating layout direction and
   * drawable state.
   *
   * @param dr the drawable to prepare
   */
  private void prepareDrawableForDisplay(@Nullable Drawable dr) {
    if (dr == null) {
      return;
    }

    dr.setLayoutDirection(getLayoutDirection());

    if (dr.isStateful()) {
      dr.setState(getDrawableState());
      dr.jumpToCurrentState();
    }
  }

  /**
   * @hide
   */
  protected void resetResolvedDrawables() {
    super.resetResolvedDrawables();
    mLastLayoutDirection = -1;
  }

  /**
   * @hide
   */
  protected void viewClicked(InputMethodManager imm) {
    if (imm != null) {
      imm.viewClicked(this);
    }
  }

  /**
   * Deletes the range of text [start, end[.
   * @hide
   */
  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
  protected void deleteText_internal(int start, int end) {
    ((Editable) mText).delete(start, end);
  }

  /**
   * Replaces the range of text [start, end[ by replacement text
   * @hide
   */
  protected void replaceText_internal(int start, int end, CharSequence text) {
    ((Editable) mText).replace(start, end, text);
  }

  /**
   * Sets a span on the specified range of text
   * @hide
   */
  protected void setSpan_internal(Object span, int start, int end, int flags) {
    ((Editable) mText).setSpan(span, start, end, flags);
  }

  /**
   * Moves the cursor to the specified offset position in text
   * @hide
   */
  protected void setCursorPosition_internal(int start, int end) {
    Selection.setSelection(((Editable) mText), start, end);
  }

  /**
   * An Editor should be created as soon as any of the editable-specific fields (grouped
   * inside the Editor object) is assigned to a non-default value.
   * This method will create the Editor if needed.
   *
   * A standard TextView (as well as buttons, checkboxes...) should not qualify and hence will
   * have a null Editor, unlike an EditText. Inconsistent in-between states will have an
   * Editor for backward compatibility, as soon as one of these fields is assigned.
   *
   * Also note that for performance reasons, the mEditor is created when needed, but not
   * reset when no more edit-specific fields are needed.
   */
  @UnsupportedAppUsage
  private void createEditorIfNeeded() {
    if (mEditor == null) {
      mEditor = new Editor(this);
    }
  }

  /**
   * @hide
   */
  @Override
  @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
  public CharSequence getIterableTextForAccessibility() {
    return mText;
  }

  private void ensureIterableTextForAccessibilitySelectable() {
    if (!(mText instanceof Spannable)) {
      setText(mText, BufferType.SPANNABLE);
      if (getLayout() == null) {
        assumeLayout();
      }
    }
  }

  /**
   * @hide
   */
  @Override
  public TextSegmentIterator getIteratorForGranularity(int granularity) {
    switch (granularity) {
      case AccessibilityNodeInfo.MOVEMENT_GRANULARITY_LINE: {
        Spannable text = (Spannable) getIterableTextForAccessibility();
        if (!TextUtils.isEmpty(text) && getLayout() != null) {
          AccessibilityIterators.LineTextSegmentIterator iterator =
            AccessibilityIterators.LineTextSegmentIterator.getInstance();
          iterator.initialize(text, getLayout());
          return iterator;
        }
      } break;
      case AccessibilityNodeInfo.MOVEMENT_GRANULARITY_PAGE: {
        Spannable text = (Spannable) getIterableTextForAccessibility();
        if (!TextUtils.isEmpty(text) && getLayout() != null) {
          AccessibilityIterators.PageTextSegmentIterator iterator =
            AccessibilityIterators.PageTextSegmentIterator.getInstance();
          iterator.initialize(this);
          return iterator;
        }
      } break;
    }
    return super.getIteratorForGranularity(granularity);
  }

  /**
   * @hide
   */
  @Override
  public int getAccessibilitySelectionStart() {
    return getSelectionStart();
  }

  /**
   * @hide
   */
  public boolean isAccessibilitySelectionExtendable() {
    return true;
  }

  /**
   * @hide
   */
  public void prepareForExtendedAccessibilitySelection() {
    requestFocusOnNonEditableSelectableText();
  }

  /**
   * @hide
   */
  @Override
  public int getAccessibilitySelectionEnd() {
    return getSelectionEnd();
  }

  /**
   * @hide
   */
  @Override
  public void setAccessibilitySelection(int start, int end) {
    if (getAccessibilitySelectionStart() == start
        && getAccessibilitySelectionEnd() == end) {
      return;
    }
    CharSequence text = getIterableTextForAccessibility();
    if (Math.min(start, end) >= 0 && Math.max(start, end) <= text.length()) {
      Selection.setSelection((Spannable) text, start, end);
    } else {
      Selection.removeSelection((Spannable) text);
    }
    // Hide all selection controllers used for adjusting selection
    // since we are doing so explicitlty by other means and these
    // controllers interact with how selection behaves.
    if (mEditor != null) {
      mEditor.hideCursorAndSpanControllers();
      mEditor.stopTextActionMode();
    }
  }

  /** @hide */
  @Override
  protected void encodeProperties(@NonNull ViewHierarchyEncoder stream) {
    super.encodeProperties(stream);

    TruncateAt ellipsize = getEllipsize();
    stream.addProperty("text:ellipsize", ellipsize == null ? null : ellipsize.name());
    stream.addProperty("text:textSize", getTextSize());
    stream.addProperty("text:scaledTextSize", getScaledTextSize());
    stream.addProperty("text:typefaceStyle", getTypefaceStyle());
    stream.addProperty("text:selectionStart", getSelectionStart());
    stream.addProperty("text:selectionEnd", getSelectionEnd());
    stream.addProperty("text:curTextColor", mCurTextColor);
    stream.addUserProperty("text:text", mText == null ? null : mText.toString());
    stream.addProperty("text:gravity", mGravity);
  }

  /**
   * User interface state that is stored by TextView for implementing
   * {@link View#onSaveInstanceState}.
   */
  public static class SavedState extends BaseSavedState {
    int selStart = -1;
    int selEnd = -1;
    @UnsupportedAppUsage
    CharSequence text;
    boolean frozenWithFocus;
    CharSequence error;
    ParcelableParcel editorState;  // Optional state from Editor.

    SavedState(Parcelable superState) {
      super(superState);
    }

    @Override
    public void writeToParcel(Parcel out, int flags) {
      super.writeToParcel(out, flags);
      out.writeInt(selStart);
      out.writeInt(selEnd);
      out.writeInt(frozenWithFocus ? 1 : 0);
      TextUtils.writeToParcel(text, out, flags);

      if (error == null) {
        out.writeInt(0);
      } else {
        out.writeInt(1);
        TextUtils.writeToParcel(error, out, flags);
      }

      if (editorState == null) {
        out.writeInt(0);
      } else {
        out.writeInt(1);
        editorState.writeToParcel(out, flags);
      }
    }

    @Override
    public String toString() {
      String str = "TextView.SavedState{"
                   + Integer.toHexString(System.identityHashCode(this))
                   + " start=" + selStart + " end=" + selEnd;
      if (text != null) {
        str += " text=" + text;
      }
      return str + "}";
    }

    @SuppressWarnings("hiding")
    public static final @android.annotation.NonNull Parcelable.Creator<SavedState> CREATOR =
      new Parcelable.Creator<SavedState>() {
        public SavedState createFromParcel(Parcel in) {
          return new SavedState(in);
        }

        public SavedState[] newArray(int size) {
          return new SavedState[size];
        }
      };

    private SavedState(Parcel in) {
      super(in);
      selStart = in.readInt();
      selEnd = in.readInt();
      frozenWithFocus = (in.readInt() != 0);
      text = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in);

      if (in.readInt() != 0) {
        error = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in);
      }

      if (in.readInt() != 0) {
        editorState = ParcelableParcel.CREATOR.createFromParcel(in);
      }
    }
  }

  private static class CharWrapper implements CharSequence, GetChars, GraphicsOperations {
    @NonNull
    private char[] mChars;
    private int mStart, mLength;

    CharWrapper(@NonNull char[] chars, int start, int len) {
      mChars = chars;
      mStart = start;
      mLength = len;
    }

    /* package */ void set(@NonNull char[] chars, int start, int len) {
      mChars = chars;
      mStart = start;
      mLength = len;
    }

    public int length() {
      return mLength;
    }

    public char charAt(int off) {
      return mChars[off + mStart];
    }

    @Override
    public String toString() {
      return new String(mChars, mStart, mLength);
    }

    public CharSequence subSequence(int start, int end) {
      if (start < 0 || end < 0 || start > mLength || end > mLength) {
        throw new IndexOutOfBoundsException(start + ", " + end);
      }

      return new String(mChars, start + mStart, end - start);
    }

    public void getChars(int start, int end, char[] buf, int off) {
      if (start < 0 || end < 0 || start > mLength || end > mLength) {
        throw new IndexOutOfBoundsException(start + ", " + end);
      }

      System.arraycopy(mChars, start + mStart, buf, off, end - start);
    }

    @Override
    public void drawText(BaseCanvas c, int start, int end,
                         float x, float y, Paint p) {
      c.drawText(mChars, start + mStart, end - start, x, y, p);
    }

    @Override
    public void drawTextRun(BaseCanvas c, int start, int end,
                            int contextStart, int contextEnd, float x, float y, boolean isRtl, Paint p) {
      int count = end - start;
      int contextCount = contextEnd - contextStart;
      c.drawTextRun(mChars, start + mStart, count, contextStart + mStart,
                    contextCount, x, y, isRtl, p);
    }

    public float measureText(int start, int end, Paint p) {
      return p.measureText(mChars, start + mStart, end - start);
    }

    public int getTextWidths(int start, int end, float[] widths, Paint p) {
      return p.getTextWidths(mChars, start + mStart, end - start, widths);
    }

    public float getTextRunAdvances(int start, int end, int contextStart,
                                    int contextEnd, boolean isRtl, float[] advances, int advancesIndex,
                                    Paint p) {
      int count = end - start;
      int contextCount = contextEnd - contextStart;
      return p.getTextRunAdvances(mChars, start + mStart, count,
                                  contextStart + mStart, contextCount, isRtl, advances,
                                  advancesIndex);
    }

    public int getTextRunCursor(int contextStart, int contextEnd, boolean isRtl,
                                int offset, int cursorOpt, Paint p) {
      int contextCount = contextEnd - contextStart;
      return p.getTextRunCursor(mChars, contextStart + mStart,
                                contextCount, isRtl, offset + mStart, cursorOpt);
    }
  }

  private static final class Marquee {
    // TODO: Add an option to configure this
    private static final float MARQUEE_DELTA_MAX = 0.07f;
    private static final int MARQUEE_DELAY = 1200;
    private static final int MARQUEE_DP_PER_SECOND = 30;

    private static final byte MARQUEE_STOPPED = 0x0;
    private static final byte MARQUEE_STARTING = 0x1;
    private static final byte MARQUEE_RUNNING = 0x2;

    private final WeakReference<TextView> mView;
    private final Choreographer mChoreographer;

    private byte mStatus = MARQUEE_STOPPED;
    private final float mPixelsPerMs;
    private float mMaxScroll;
    private float mMaxFadeScroll;
    private float mGhostStart;
    private float mGhostOffset;
    private float mFadeStop;
    private int mRepeatLimit;

    private float mScroll;
    private long mLastAnimationMs;

    Marquee(TextView v) {
      final float density = v.getContext().getResources().getDisplayMetrics().density;
      mPixelsPerMs = MARQUEE_DP_PER_SECOND * density / 1000f;
      mView = new WeakReference<TextView>(v);
      mChoreographer = Choreographer.getInstance();
    }

    private Choreographer.FrameCallback mTickCallback = new Choreographer.FrameCallback() {
      @Override
      public void doFrame(long frameTimeNanos) {
        tick();
      }
    };

    private Choreographer.FrameCallback mStartCallback = new Choreographer.FrameCallback() {
      @Override
      public void doFrame(long frameTimeNanos) {
        mStatus = MARQUEE_RUNNING;
        mLastAnimationMs = mChoreographer.getFrameTime();
        tick();
      }
    };

    private Choreographer.FrameCallback mRestartCallback = new Choreographer.FrameCallback() {
      @Override
      public void doFrame(long frameTimeNanos) {
        if (mStatus == MARQUEE_RUNNING) {
          if (mRepeatLimit >= 0) {
            mRepeatLimit--;
          }
          start(mRepeatLimit);
        }
      }
    };

    void tick() {
      if (mStatus != MARQUEE_RUNNING) {
        return;
      }

      mChoreographer.removeFrameCallback(mTickCallback);

      final TextView textView = mView.get();
      if (textView != null && textView.isAggregatedVisible()
          && (textView.isFocused() || textView.isSelected())) {
        long currentMs = mChoreographer.getFrameTime();
        long deltaMs = currentMs - mLastAnimationMs;
        mLastAnimationMs = currentMs;
        float deltaPx = deltaMs * mPixelsPerMs;
        mScroll += deltaPx;
        if (mScroll > mMaxScroll) {
          mScroll = mMaxScroll;
          mChoreographer.postFrameCallbackDelayed(mRestartCallback, MARQUEE_DELAY);
        } else {
          mChoreographer.postFrameCallback(mTickCallback);
        }
        textView.invalidate();
      }
    }

    void stop() {
      mStatus = MARQUEE_STOPPED;
      mChoreographer.removeFrameCallback(mStartCallback);
      mChoreographer.removeFrameCallback(mRestartCallback);
      mChoreographer.removeFrameCallback(mTickCallback);
      resetScroll();
    }

    private void resetScroll() {
      mScroll = 0.0f;
      final TextView textView = mView.get();
      if (textView != null) textView.invalidate();
    }

    void start(int repeatLimit) {
      if (repeatLimit == 0) {
        stop();
        return;
      }
      mRepeatLimit = repeatLimit;
      final TextView textView = mView.get();
      if (textView != null && textView.mLayout != null) {
        mStatus = MARQUEE_STARTING;
        mScroll = 0.0f;
        final int textWidth = textView.getWidth() - textView.getCompoundPaddingLeft()
                              - textView.getCompoundPaddingRight();
        final float lineWidth = textView.mLayout.getLineWidth(0);
        final float gap = textWidth / 3.0f;
        mGhostStart = lineWidth - textWidth + gap;
        mMaxScroll = mGhostStart + textWidth;
        mGhostOffset = lineWidth + gap;
        mFadeStop = lineWidth + textWidth / 6.0f;
        mMaxFadeScroll = mGhostStart + lineWidth + lineWidth;

        textView.invalidate();
        mChoreographer.postFrameCallback(mStartCallback);
      }
    }

    float getGhostOffset() {
      return mGhostOffset;
    }

    float getScroll() {
      return mScroll;
    }

    float getMaxFadeScroll() {
      return mMaxFadeScroll;
    }

    boolean shouldDrawLeftFade() {
      return mScroll <= mFadeStop;
    }

    boolean shouldDrawGhost() {
      return mStatus == MARQUEE_RUNNING && mScroll > mGhostStart;
    }

    boolean isRunning() {
      return mStatus == MARQUEE_RUNNING;
    }

    boolean isStopped() {
      return mStatus == MARQUEE_STOPPED;
    }
  }

  private class ChangeWatcher implements TextWatcher, SpanWatcher {

    private CharSequence mBeforeText;

    public void beforeTextChanged(CharSequence buffer, int start,
                                  int before, int after) {
      if (DEBUG_EXTRACT) {
        Log.v(LOG_TAG, "beforeTextChanged start=" + start
                       + " before=" + before + " after=" + after + ": " + buffer);
      }

      if (AccessibilityManager.getInstance(mContext).isEnabled() && (mTransformed != null)) {
        mBeforeText = mTransformed.toString();
      }

      TextView.this.sendBeforeTextChanged(buffer, start, before, after);
    }

    public void onTextChanged(CharSequence buffer, int start, int before, int after) {
      if (DEBUG_EXTRACT) {
        Log.v(LOG_TAG, "onTextChanged start=" + start
                       + " before=" + before + " after=" + after + ": " + buffer);
      }
      TextView.this.handleTextChanged(buffer, start, before, after);

      if (isVisibleToAccessibility()) {
        sendAccessibilityEventTypeViewTextChanged(mBeforeText, start, before, after);
        mBeforeText = null;
      }
    }

    public void afterTextChanged(Editable buffer) {
      if (DEBUG_EXTRACT) {
        Log.v(LOG_TAG, "afterTextChanged: " + buffer);
      }
      TextView.this.sendAfterTextChanged(buffer);

      if (MetaKeyKeyListener.getMetaState(buffer, MetaKeyKeyListener.META_SELECTING) != 0) {
        MetaKeyKeyListener.stopSelecting(TextView.this, buffer);
      }
    }

    public void onSpanChanged(Spannable buf, Object what, int s, int e, int st, int en) {
      if (DEBUG_EXTRACT) {
        Log.v(LOG_TAG, "onSpanChanged s=" + s + " e=" + e
                       + " st=" + st + " en=" + en + " what=" + what + ": " + buf);
      }
      TextView.this.spanChange(buf, what, s, st, e, en);
    }

    public void onSpanAdded(Spannable buf, Object what, int s, int e) {
      if (DEBUG_EXTRACT) {
        Log.v(LOG_TAG, "onSpanAdded s=" + s + " e=" + e + " what=" + what + ": " + buf);
      }
      TextView.this.spanChange(buf, what, -1, s, -1, e);
    }

    public void onSpanRemoved(Spannable buf, Object what, int s, int e) {
      if (DEBUG_EXTRACT) {
        Log.v(LOG_TAG, "onSpanRemoved s=" + s + " e=" + e + " what=" + what + ": " + buf);
      }
      TextView.this.spanChange(buf, what, s, -1, e, -1);
    }
  }

  /** @hide */
  @Override
  public void onInputConnectionOpenedInternal(@NonNull InputConnection ic,
                                              @NonNull EditorInfo editorInfo, @Nullable Handler handler) {
    if (mEditor != null) {
      mEditor.getDefaultOnReceiveContentListener().setInputConnectionInfo(this, ic,
                                                                          editorInfo);
    }
  }

  /** @hide */
  @Override
  public void onInputConnectionClosedInternal() {
    if (mEditor != null) {
      mEditor.getDefaultOnReceiveContentListener().clearInputConnectionInfo();
    }
  }

  /**
   * Default {@link TextView} implementation for receiving content. Apps wishing to provide
   * custom behavior should configure a listener via {@link #setOnReceiveContentListener}.
   *
   * <p>For non-editable TextViews the default behavior is a no-op (returns the passed-in
   * content without acting on it).
   *
   * <p>For editable TextViews the default behavior is to insert text into the view, coercing
   * non-text content to text as needed. The MIME types "text/plain" and "text/html" have
   * well-defined behavior for this, while other MIME types have reasonable fallback behavior
   * (see {@link ClipData.Item#coerceToStyledText}).
   *
   * @param payload The content to insert and related metadata.
   *
   * @return The portion of the passed-in content that was not handled (may be all, some, or none
   * of the passed-in content).
   */
  @Nullable
  @Override
  public ContentInfo onReceiveContent(@NonNull ContentInfo payload) {
    if (mEditor != null) {
      return mEditor.getDefaultOnReceiveContentListener().onReceiveContent(this, payload);
    }
    return payload;
  }

  private static void logCursor(String location, @Nullable String msgFormat, Object ... msgArgs) {
    if (msgFormat == null) {
      Log.d(LOG_TAG, location);
    } else {
      Log.d(LOG_TAG, location + ": " + String.format(msgFormat, msgArgs));
    }
  }

  /**
   * Collects a {@link ViewTranslationRequest} which represents the content to be translated in
   * the view.
   *
   * <p>NOTE: When overriding the method, it should not collect a request to translate this
   * TextView if it is displaying a password.
   *
   * @param supportedFormats the supported translation format. The value could be {@link
   *                         android.view.translation.TranslationSpec#DATA_FORMAT_TEXT}.
   * @param requestsCollector {@link Consumer} to receiver the {@link ViewTranslationRequest}
   *                                         which contains the information to be translated.
   */
  @Override
  public void onCreateViewTranslationRequest(@NonNull int[] supportedFormats,
                                             @NonNull Consumer<ViewTranslationRequest> requestsCollector) {
    if (supportedFormats == null || supportedFormats.length == 0) {
      if (UiTranslationController.DEBUG) {
        Log.w(LOG_TAG, "Do not provide the support translation formats.");
      }
      return;
    }
    ViewTranslationRequest.Builder requestBuilder =
      new ViewTranslationRequest.Builder(getAutofillId());
    // Support Text translation
    if (ArrayUtils.contains(supportedFormats, TranslationSpec.DATA_FORMAT_TEXT)) {
      if (mText == null || mText.length() == 0) {
        if (UiTranslationController.DEBUG) {
          Log.w(LOG_TAG, "Cannot create translation request for the empty text.");
        }
        return;
      }
      boolean isPassword = isAnyPasswordInputType() || hasPasswordTransformationMethod();
      if (isTextEditable() || isPassword) {
        Log.w(LOG_TAG, "Cannot create translation request. editable = "
                       + isTextEditable() + ", isPassword = " + isPassword);
        return;
      }
      // TODO(b/176488462): apply the view's important for translation
      requestBuilder.setValue(ViewTranslationRequest.ID_TEXT,
                              TranslationRequestValue.forText(mText));
      if (!TextUtils.isEmpty(getContentDescription())) {
        requestBuilder.setValue(ViewTranslationRequest.ID_CONTENT_DESCRIPTION,
                                TranslationRequestValue.forText(getContentDescription()));
      }
    }
    requestsCollector.accept(requestBuilder.build());
  }
}